Overview of Batch Files (N1 Service Provisioning System 4.1 Reference Guide)

N1 Service Provisioning System 4.1 Reference Guide

Overview of Batch Files

The rsrc.cib operates on a batch file that includes a line for each resource that will be checked in. Batch files enable you to check-in large numbers of resources with a single command.

Each line in the batch file corresponds to a single resource on the local machine that will be checked in as a single resource. Each line consists of a series of fields that are separated by the pipe character (|). Some fields are optional and may be omitted. If an optional field is omitted but is followed by other fields, the omitted field should be followed by a | character, so that rsrc.cib can accurately identify each field.

You can include comments in a batch file. Any line that begins with the pound character (#) is interpreted as a comment.

Table 13–4 describes the syntax of a line of a batch file.

Table 13–4 Syntax of a Line in a Batch File


Content	Optional/Required
The location of the resource on the local machine	Required
The name to be assigned to the resource when checked in	Required
The resource type	Required
The platform the resource is intended for expressed as a HostSetID in the form NM:<platform_name>, where <platform_name> is one of the names listed in Table 13–5.	Optional
A description of the resource	Optional
A boolean designation of whether the file is a configuration file	Optional (Default is false)
A boolean designation of whether check-in should be assigned a major version number (e.g., 2.0)	Optional (Default is false)
A boolean designation of whether to hide the previous most recent version of the resource	Optional (Default is true)
A boolean designation of whether to include owner information when storing permissions information	Optional (Default is true)
A boolean designation of whether to include group information when storing permissions information	Optional (Default is true)
A boolean designation of whether the files being checked in should be added to the existing files to create a new version, instead of creating a new version by completely replacing the existing files	Optional (Default is true)
If this resource is being checked in a from a host, the host ID of the host from which the resource is being checked in	Optional
A boolean designation of whether redundancy checking should apply	Optional (Default is true)
A boolean designation of whether the source file was exported. If true, the following parameters are not used: includeOwners, includeGroups, and addTo..	Optional (Default is false)
A string identifying the export path of the (previously exported) resource; that is, the type-specific path the resource had before it was exported. .	Required if the exported value is true
The name of the picker to use (optional, defaults to null for the default picker)
A Hastable in string from containing extra options supported by the type's exporter. (See cdb.rsrc.showopts.)

The table below lists the names that you can use in the fourth field of a batch file line to specify a platform for the component.

Table 13–5 Names for Platforms


Platform Name	Description
`any`	Any platform supported by the N1 Service Provisioning System software
`AIX - any version`	Either IBM AIX 4.3.3 or IBM AIX 5.1
`AIX 4.3.3`	IBM AIX 4.3.3
`AIX 5.1`	IBM AIX 5.1
`Solaris - any version`	Solaris^TM 6, Solaris 7, or Solaris 8 releases
`Solaris 6`	Solaris 6 release
`Solaris 7`	Solaris 7 release
`Solaris 8`	Solaris 8 release
`Windows 2000 Server`	Microsoft Windows 2000 Server
`Red Hat Linux`	Red Hat Linux 7.2, 7.3, 8.0 Red Hat Advanced Server 2.1