PERMANENT DATASET UTILITIES 11
11.1 AUDIT - AUDIT PERMANENT DATASETS
The AUDIT utility reports the status of all the permanent datasets known to the system. AUDIT does not include input and output datasets.
If more than one parameter is selected, only those datasets that meet all criteria are listed.
AUDIT can supply the following information on the output listing:
• Permanent dataset name
• Dataset identifier
• Edition number
• User identifications
• Dataset size in words
• Retention time
• Number of accesses
• Public access mode
• Total block count
• Track access flag setting
• Creation date/time
• Last dump date/time
• Last access date/time
• Last modification date/time
• Device name
• note
information• text
information• Permitted users
• Access counts by user
• Number of datasets selected
• Current residency
• Preferred residency
11-2 SR-0011 0
---.
-Format:
AUDIT,L=ldn,B=bdn,PDN=pdn,ID=uid,US=usn,ACN=dcn,Dv=dvn
,SZ=dsz, ACC=opt:opt,x=mmlddlyy:'hh:mm:sS',TCR=mmlddlyy: 'hh:mm:ss',
TLA=mmlddlyy:
'hh:mm:sS',TLM=mmlddlyy:'hh:mm:ss',CW=CW, OWN=OV,LO=opt: ... opt,BO=opt: ... Opt.
L=ldn
B=bdn
PDN=pdn ID=uid
US=usn
ACN=dcn
Dv=dvn
sz=dsz
Lists dataset name; default is $OUT.
Name of dataset to receive the binary output. If B is specified alone, the dataset is $BINAUD. If the B parameter is omitted, no binary output is written.
Name of permanent dataset or datasets to be listed
Lists all permanent datasets with the specified additional user identification. The default is to list all IDs. If ID is present without an equated value, datasets having a null ID are selected.
Lists all permanent datasets with the specified user number. The default is to list all user numbers.
Lists all permanent datasets with the specified account number. The default is to list datasets without respect to account number.
Lists all permanent datasets on the specified logical device. The default is to list permanent datasets on all devices.
Lists all permanent datasets greater than or equal to the specified size. Size is specified in words. The default is to list all sizes.
ACC=Opt:Opt
Access option parameters. The options are as follows:
AM Lists only those datasets belonging to OWN that have an explicit permit for the job's ownership value PAM Lists only those datasets belonging to OWN that
have any form of public access (R:W:M:E)
SR-0011 0 11-3
If the OWN parameter is omitted, all datasets are searched for the permit or public access. If the CW parameter is specified, the AM includes any permit for any owner value.
If the OWN parameter is specified and the CW and ACC parameters are omitted, AUDIT assumes the ACC=AM:PAM parameter on the control statement.
x=mmlddlyy: 'hh:mm:ss'
Lists all permanent datasets expired as of the specified mmlddlyy:'hh:mm:ss'. mmlddlyy can be
specified alone. The default expiration date and time are
"now" if only X is specified.
TCR=mmlddlyy: 'hh:mm:ss'
Lists all permanent datasets that have been created since the specified mmlddlyy: 'hh:mm:ss'. The keyword
cannot be specified alone; however, TCR=mmlddlyy is sufficient.
TLA=mmlddlyy: 'hh:mm:ss'
Lists all permanent datasets that have not been accessed since the specified mmlddlyy: 'hh:mm:ss'. The keyword cannot be specified alone; however, TLA=mmlddlyy is sufficient.
TLM=mmlddlyy:'hh:mm:ss'
CW=cw
OWN=ov
Lists all permanent datasets that have been modified since the specified mmlddlyy:'hh:mm:ss'. The keyword cannot be specified alone; however, TLM=mmlddlyy is sufficient.
Site-defined control word regulating the use of AUDIT. If the CW parameter is omitted, only the datasets belonging to the job owner can be listed. If the CW parameter is
present and the correct control word is used, any dataset can be listed. If an invalid control word is given, the job step is aborted. When the CW and ACC parameters are omitted, but the OWN parameter is specified, AUDIT assumes the ACC=AM:PAM parameter on the control statement.
Lists all permanent datasets with the specified ownership value. If OWN is not specified, the job's ownership value is used.
Output formatting parameters are the following:
11-4
LO=Opt: ••• Opt
Listing option selection. S is the default for interactive jobs; L, for batch. The S option cannot be mixed with any others.
The following options can be specified alone or in combination separated by colons:
SR-0011 0
LO=Opt: ... Opt
(continued) A Access tracking. Includes accessing owner name, access count, time of last access, and time of first access.
B Backup. Reports the tape volume names on which the current back-up copy resides, the number of space management deletions and reloads, and the status of internal flags indicating whether the dataset is a candidate for backup or recall. Also specify the CW parameter if this option is used.
L Long list. Consists of PON, 10, ED, size in words, retention time, access count, track access flag, public access mode (PAM), creation, last access, last modification, last dump time, device name, preferred
residency (PR), and current residency (CR). L is used for batch jobs when LO is not specified. It lists information for on-line or migrated datasets only.
N Notes list. Displays the dataset catalog
notes
field.
P Permit list. Includes permitted owner name, access mode, access count, time of last access, and time of permit creation.
R Retired datasets listing. Consists of the same categories of information as LO=L but for retired datasets only.
S Short list. Includes PDN, ID, and ED listed two per line. This is used for interactive jobs when LO is not specified.
T Text list. Displays the dataset catalog
text
field.X Extended long list. Includes everything in the long list (L) plus an indication of the dataset's allocated (ALLOC) size (shown immediately below the dataset's size (SZ». The extended long list also includes a line immediately below the dataset size summary that gives the number of blocks and words allocated.
BO=Opt: ... Opt
SR-0011 0
Binary audit options. These options specify what additional information, if any, is to be added to the standard binary audit file. They are ignored without comment unless a binary audit is requested by the B parameter. If more than one option is desired, separate them with colons. The options are as follows:
11-5
BO=opt: ... Opt
(continued) A
B
Access tracking. Generates one record for each accessing user for each selected dataset.
Backup. Reports the tape volume name(s) on which the current back-up copy resides, the number of space management deletions and reloads, and the status of internal flags indicating whether the dataset is a candidate for backup or recall. The ew parameter must be specified if this option is used.
N Notes. Generates one record for each selected dataset that has
notes.
P Permits. Generates one permit record for each permitted user for each selected dataset.
R Retired datasets listing. Consists of PDN, ID, ED, size in words, retention time, access count, track access flag, PAM, creation, last access, last
modification, last dump time, device name, PR, and CR.
T Text. Generates one record for each selected dataset that has
text.
X Adds a field to the regular binary audit record indicating the allocated word size of the dataset.
This is the same value as the ALLoe field on the LO=X output.
Figures 11-1 through 11-6 show some of the LO options as they appear when the listing is directed to a mass storage dataset. Interactive reports omit the page header line. Systems in which the Permanent Dataset
Privacy feature is not enabled suppress the owner line unless OWN is used as a control statement parameter.
11-6 SR-0011 0