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

Usage Notes
Examples
profiles
identifies the total number of profiles defined in the source directory.
userids
identifies the total number of virtual machine IDs defined in the directory
control file, which is the sum of the number of USER statements without
POOL statements and the number of users defined by the POOL
statements.
totgrents
identifies the total number of POSIXGROUP statements, plus all groups
listed in all POSIXGLIST statements, plus all groups specified in all
POSIXINFO statements, plus 1.
5. If no errors occur, and EDIT is not specified, the program writes the directory on
DASD and the DASD address of the new directory on the volume label for that
device. If the program is updating an active system directory, the program
makes the new directory immediately available for the system.
1. You must have CP privilege class A, B, or C to update the system user
directory.
2. A complete description of the directory program, including a description of
directory control statements, is contained in z/VM: CP Planning and
Administration.
3. When writing a user directory, DIRECTXA does not overwrite the current
directory, but does write an alternate user directory. The directory pointer in the
volume label is then changed to refer to this new directory.
4. You should be careful to target a different physical pack when using the
DIRECTXA utility from a new version of VM to create a CP user directory for
that new version of the system, by running it under the old system.
5. If the directory specified on the DIRECTXA command is not the current
directory, the directory that is created by this utility is not brought online.
6. The MIXED, MIXMSG, NOMIXMSG, EDIT and SYSAFNID options are not
positional and can be entered in any order. However, if the SYSAFNID option is
specified, the EDIT option also must be specified. If the MIXMSG or
NOMIXMSG option is specified, the MIXED option also must be specified.
7. The MIXED option should be used during migration from other releases of VM,
such as VM/XA SP 2.1, VM/SP HPO Release 5, and VM/ESA, when operating
in a mixed cross system extensions (CSE) environment.
8. On z/VM V5R1, a request for a V=R or V=F virtual machine will result in the
user being logged on as a V=V virtual machine.
To compile the USER DIRECT source directory and apply it to the system if
successful, enter direcxta user direct *.
DIRECTXA
To do a test compile of a USER DIRECT source directory from a VM/SP HPO 5
system to see which control statements are HPO-only or contain HPO-only options,
enter directxa user direct * (edit mixed.
To do a test compile of a USER DIRECT source directory for a specific system
named SYSVMA in a mixed complex of systems sharing the source directory, enter
directxa user direct * (edit mixed mixmsg sysafnid sysvma.
Chapter 3. CP Utilities 1817