z/VM: CP Commands and Utilities Reference - z/VM - IBM

DIRECTXA
EDIT
lets you enter the DIRECTXA command without updating the directory on disk.
With this option, you can check the syntax of directory control statements.
SYSAFNID sysafnid
identifies a 1- to 8-character alphanumeric value that must correspond to a
system affinity ID specified on one of the DIRECTORY control statements in the
source directory named in the DIRECTXA command. This option can be used
only with the EDIT option, and it specifies that the DIRECTXA utility is to
compile the source directory as if it were executing on the system identified by
sysafnid.
&SYSRES volid
is a one to six-character value that is used to represent the volume serial
number of the system residence volume for minidisks defined using the
symbolic value &SYSRES. This value is used in responses to the VMUDQ
LSTMDISK function. It need not be the actual system residence volume serial
number. If this option is omitted, a value of +VMRES is used.
How the Directory Program Works
1816 z/VM: CP Commands and Utilities Reference
The DIRECTXA utility performs the following steps during execution:
1. The program looks for the file you specify on the DIRECTXA command line. If
you do not specify a file name or a file type, the program looks for a file that
has the file name of USER and a file type of DIRECT.
2. If the program does not find the source directory or an error occurs during
processing, the program does not create a directory, and the old directory
remains online. The program continues to check the syntax of all control
statements before ending.
3. DIRECTXA looks for the RPWLIST DATA file, which contains a list of restricted
passwords. The RPWLIST DATA file is supplied on your system. You can edit
this file to add your own restricted passwords. (The z/VM Installation and
Service Sample Files document also contains a copy of the RPWLIST DATA file.
This document is supplied with your z/VM product order.) If the RPWLIST DATA
file is not found, DIRECTXA issues a warning message but continues
processing. If the RPWLIST DATA file is found, DIRECTXA checks all the
passwords in the directory against it and changes any restricted passwords
(except the password of the user issuing the DIRECTXA command) to NOLOG.
Any user whose password is changed to NOLOG cannot log on. If the password
of the virtual machine issuing the DIRECTXA command is restricted, it is not
changed to NOLOG. DIRECTXA issues an error message and does not update
the directory.
4. If DIRECTXA runs out of DASD space, the utility issues an error message, and
the directory is not processed. To continue, you must allocate more cylinders or
blocks for the user directory and reissue the DIRECTXA command.
If DIRECTXA runs out of virtual storage, the utility issues an error message, and
the directory is not processed. To continue, you must define more virtual storage
(DEFINE STORAGE command), re-IPL CMS, and reissue the DIRECTXA
command. Using the following formula, calculate the size of virtual storage you
need:
vstor = 140 Kb + (40 bytes X (2 + profiles + userids)) + (32 bytes X userids) +
(32 bytes X totgrents)
vstor
the amount of virtual storage in the program area that DIRECTXA requires.