Control cards used for Batch Update List processing
Control cards are used by the Batch Update List utility to specify the functions that you want. Because the only functions the Batch Update List utility can perform are Verify and Install, there are two control cards that can be used with this utility. The following general syntax rules apply to the control cards that are supplied by using the SYSIN DD statement.
- An asterisk (*) in column 1 indicates that this is a comment statement. It is ignored by the utility. A comment card cannot be continued; you must code any following comment statements with an asterisk in column 1.
- The first word on a statement must be either VERIFY or INSTALL, depending on the function that you want to perform.
- Two keywords are required for each VERIFY or INSTALL statement, IMSID= and either IMSID= or TARGET=.
- You must specify the target IMS™ system for the VERIFY or INSTALL function. You can specify a single IMSID using the IMSID= or TARGET= keywords, or a group of IMS systems by using the TARGET= keyword. Whatever IMSID or group name you specify must be defined to IMS HP Sysgen Tools through the IMSID or GROUP SETUP panels.
- The NAME= keyword identifies one or more resource update list member names that are to be verified or installed. If more than one name is specified, separate the member names with a comma, and enclose the list in parentheses. For example, NAME=(MEMBER1,MEMBER2) will select resource update lists that are named MEMBER1 and MEMBER2.
- Continuation of a statement is permitted. A comma at the end of a card indicates that the statement is continued on the next line.
The following figure shows some examples of valid control cards:
INSTALL NAME=MEMBER1,IMSID=IMSA
VERIFY IMSID=IMSA NAME=( MEMBER1 , MEMBER2 )
VERIFY TARGET=GROUP1,
NAME=(MEMBER1,
MEMBER2)
You can include multiple control cards in a single issuance of the Batch Update List utility. Each statement is processed individually. When multiple members are specified on a single control card, the members are merged and processed simultaneously. When multiple members are specified on separate control cards, they are processed individually.
To install several resource update lists in a single batch job, it is more efficient to install all the resource update lists at once (by specifying them all in a single statement). However, if one entry fails, none of the entries in any of the update lists will be installed.