Command Reference › MULTIPLE Command › Control File Records

Control File Records

A control file is a regular CMS file that contains records that describe the specifications for each virtual machine. The records in the control file used with the MULTIPLE command have positional parameters. Tokens exceeding the valid number of characters are truncated to the maximum acceptable length. The general format of these records is:

userid [{password|*} [{acct|*} [{distcode|*} [disksize [blocksize [label ]]]]]]

userid

Is the user ID to activate, place on hold, create, or remove.

The remaining parameters are valid only with the NEWUSER parameter. The command ignores these parameters if you specify them with ACTIVATE, HOLD, or REMOVE.

[ password ]

Is the password for the new user ID. The default password is the same as the user ID. To use the default password, specify an asterisk. You cannot enter a password phrase in the control file. Only passwords of up to eight characters are supported.

[ acct ]

Is the account number for the new user ID. The default account number is the one specified in the skeleton file. If there is no account number in the skeleton file, the default account number is the same as the user ID name. To use the default account number, specify an asterisk.

[ distcode ]

Is the distribution code for the user ID to create. The default distribution code is the one specified in the skeleton file. If there is no distribution code in the skeleton file, the default distribution code is the same as the user ID name. To use the default distribution code, specify an asterisk.

[ disksize ]

Is the size of the 191 minidisk to allocate, specified either as the number of 512‑byte blocks or in units of K (1024 bytes) or M (1024K bytes). By default, no 191 minidisk is created. Disk space is allocated from the default subpool or the subpool specified in response to a console prompt.

[ blocksize ]

Is the blocksize for formatting the new 191 minidisk. The default is 1K.

[ label ]

Is the minidisk label for the 191 minidisk. The default is DSK191.

Note: If you are using the IPLDISK command or if you are using the CA VM:Secure Rules Facility, the user IDs are created with logon passwords that must be changed at first logon. This is true even if a logon password was specified in the control file.

Example

To place all the user IDs in the control file USER FILE on hold, enter:

vmsecure multiple hold user file