Previous Topic: TRANSFER CommandNext Topic: UNLOCK Command


ULIST Command

Use the ULIST command to list directory entries available for management functions.

ULIST [entryname [mgrid]] [( [FILE | NOSFS]]

Definitions

[entryname [mgrid]]

Specifies directory entry names to list, and directory managers whose entries to list. Pattern‑matching syntax used by the CMS LISTFILE command is valid for specifying the entry names. An asterisk for entryname lists all entries managed by the specified directory manager. An asterisk for mgrid lists the specified directory entry names for all directory managers.

If you do not specify entryname or mgrid, the command displays all entries that you manage.

[FILE]

Writes the results of the ULIST command to a file on the issuing user ID’s A‑disk. The filename is the user ID of the issuing user; the filetype is ULIST.

[NOSFS]

Excludes SFS information from the results of the ULIST command, displaying instead N/A for any SFS‑related information. This option speeds up execution of the ULIST command because gathering SFS data can be time consuming.

Description

The ULIST command displays the User List Menu, which looks like the one shown in the following User List Menu section.

It allows directory managers to list directory entries they manage and perform full‑screen directory management functions on those entries. It also provides information about the status of logon passwords and the number of days since logon passwords have been changed.

When an asterisk is displayed in the PwAge column, it indicates that the associated user ID does not have a *PW= special comment in its associated directory entry. Therefore, there is no associated password age information to report.

If you specify the user IDs to include in this display, but CA VM:Director authorization checking indicates that you do not have ULIST authorization over some user IDs that fit this specification, the last line of this screen displays the following message:

ADDITIONAL USERS EXCLUDED BY AUTHORIZATION CHECK

For example, you request the list of F* user IDs that CARLAT manages, but you are authorized to use the ULIST command on only one of the three user IDs she manages that begin with the letter F. CA VM:Director displays this one name on the list, and also displays this message at the bottom of the screen.

CA VM:Director User List Menu

ULIST User Menu List VM:Director --‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑ Userid Manager Group PwStat PwAge Disks Alloc SFS Pools Usage FRASIERC CARLAT Exprd 315 1 300K 1 42.0K FREDERIC CARLAT 1 1 1000K 1 50.0K LILITHS CARLAT 24 1 1150K 1 4.0K NICKT CARLAT Nolog 25 1 900K REBECCAH CARLAT 55 1 2500K 1 500.0K Copyright (c) 2011 CA. All rights reserved. --‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑ PF: 1=Cancel 2=Review 3=Quit 4=Edit 5=Manage 6=User PF: 7=Backward 8=Forward 9=Mdskscan 10=Print 11=Sort 12=End

PWStat

Status of each user password.

PWAge

Age in days for each user password.

Disks

Number of minidisks allocated to each user.

Alloc

Amount of disk space allocated to each user.

SFS Pools

Number of SFS file pools where each user is enrolled.

Usage

Amount of SFS storage each user has in use.

With PF2 (Review), PF4(Edit), PF5 (Manage), PF6 (User), and PF9 (Mdskscan) you can display directory management screens. Place the cursor under the user ID you want to manage and press the PF key for the desired function. You may or may not be authorized to perform all of the functions.

You can sort the data in a column by placing the cursor in the field you want to sort on and pressing PF11 (Sort).

Password Status Values

The following table describes the Password status values:

Password Status
(PwStat Value)

Meaning

Autlg

The logon password is AUTOONLY. The user ID can only be autologged and cannot be logged on directly.

Exprd†

The logon password has been expired with the EXPIRE command.

Logby

The logon password is not expired and is LBYONLY. This password forces users to log on to this user ID using the IBM‑provided LOGONBY feature. It cannot be logged on directly.

Nolog

The logon password is NOLOG. This user ID is not allowed to log on.

Nopas

The logon password is NOPASS. The user can log on without specifying a password.

† When this value is listed as a user ID’s password status, the user ID is prompted for a new password at next logon.

Examples