PERMANENT DATASET UTILITIES 6
5 DATASETS SELECTED FOR LOADING
Figure 6-2. PDSLOAD listing
AUDIT - AUDIT PERMANENT DATASETS
The AUDIT utility provides reports on the status of each permanent dataset known to the system. AUDIT does not include input and output datasets.
If more than one parameter is selected, only those datasets which meet all criteria are listed.
AUDIT supplies the following information on the listing:
Permanent dataset name Dataset identifier Edition number
User identifications Dataset size in words Retention time in decimal Number of accesses in decimal Public access mode
Total block count in decimal Track access flag setting
Format:
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
AUDIT,L=tdn,B=bdn,PDN=pdn,ID=uid,us=usn,Dv~vn,sz~sz,
X=mm/dd/yy:'hh:mm:ss',TCR~/dd/yy:'hh:mm:ss',
TLA=mm/dd/yy:'hh:mm:ss',TLM~/dd/yy:'hh:mm:ss',cw=cw,
OWN=OV,LO=Opt:Opt:Opt:Opt:Opt,BO=Opt:Opt:Opt:Opt.
Parameters are in keyword form.
L=tdn B=bdn
PDN=pdn
SR-OOIl
List dataset name. The 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. For a description of the binary output format, see the Binary Audit Table description in the COS Table Descriptions Internal Reference Manual, CRI publications SM-0045.
Name of permanent dataset or datasets to be listed
Part 2
6-8 L
ID=uid
US=usn
Dv=dvn
sZ=dsz
List all permanent datasets with the specified additional user identification. The default is to list all IDs. If ID specified mm/dd/yy:'hh:mm:ss'. The keyword cannot be
specified alone; however, TCR=mm/dd/yy is sufficient.
TLA=mm/dd/yy:'hh:mm:ss'
List all permanent datasets that have not been accessed since the specified mm/dd/yy:'hh:mm:ss'. The keyword cannot be specified alone; however, TLA=mm/dd/yy is sufficient.
TLM=mm/dd/yy:'hh:mm:ss'
cw=cw
OWN=ov
List all permanent datasets that have been modified since the specified mm/dd/yy:'hh:mm:ss'. The keyword cannot be specified alone; however, TLM=mrnvdd/yy is sufficient.
Installation-defined control word regulating use of AUDIT.
If the OW parameter is omitted, only the datasets belonging to the job owner can be listed. If the OW 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.
List all permanent datasets with the specified ownership value. If OWN is not specified, the job's ownership value is used.
Output formatting parameters:
LO=Opt:Opt:Opt:Opt:Opt
Listing option selection. The options are:
S Short list per line.
when LO is mixed with
which includes PON, ID, and ED listed two This is the default for interactive jobs not specified. This list option cannot be any others.
The following options can be specified alone or in combination separated by colons:
L Long list which includes PON, IO, ED, size in words, retention time, access count, track access flag, public access mode, creation, last access, last modification, last dump time, and device name. L is the default for batch jobs when LO is not specified.
P Permit list which includes permitted owner name, access mode, access count, time of last access, and time of permit creation
A Access tracking which includes accessing owner name, access count, time of last access, and time of first access
T Text list which displays the dataset catalog text field
N Notes list which displays the dataset catalog notes field
BO=Opt:Opt:Opt:Opt
SR-OOll
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 (via the B parameter). If more than one option is desired, separate them with colons. The options are:
P Permits; one permit record is generated for each permitted user for each selected dataset.
A Access tracking; one record is generated for each accessing user for each selected dataset.
T Text; one record is generated for each selected dataset that has text.
N Notes; one record is generated for each selected dataset that has notes.
Part 2
6-10 L
Figures 6-3 through 6-7 illustrate 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.
AUDIT COS X.12 OS/24/83 12:35:33 PAGE
PDN ID ED PDN ID ED
$ DEBUG DJB 1 $DS DJB 5
gOVL DJB 5 ARCHIVE DJB 1
ARCHIVE DJB 2 AUDIT DJB 1
COSNL DJB 1 ISAMPL DJB 1
PROFILE DJB 1
9 DATASETS, 3099 BLOCKS, 1585585 WORDS
Figure 6-3. AUDIT, LO=S listing
AUDIT COS X.12 OS/24/83 12:35:45 PAGE
ID = DJB
PERMITTED USERS USER
XYZ ABCD
QRZX ZILCH
PERMITTED USERS USER
XYZ ABCD
QRZX ZILCH
9 DATASETS,
FOR PDN = ARCHIVE ID = DJB
AM ACC LAST ACCESS CREATED
RWM 0 05/16/83 12:09:09
R 0 OS/20/83 06:46:13
RW 0 OS/20/83 06:46:28
E 0 OS/20/83 06:46:49
FOR PDN ARCHIVE ID = DJB
AM ACC LAST ACCESS CREATED
RWM 0 05/16/83 12:09:09
R 0 OS/20/83 06:46:13
RW 0 OS/20/83 06:46:28
E 0 OS/20/83 06:46:49
3099 BLOCKS, 1585585 WORDS
1
1
AUDIT
AUDIT USER
XYZ ABCD
QRZX ZILCH
PDN
SZ
ARCHIVE 3671
COS X.12 OS/24/83 12:36:10 PAGE
AM ACC LAST ACCESS CREATED
RWM 0 05/16/83 12:09:09
R 0 OS/20/83 06:46:13
RW 0 OS/20/83 06:46:28
E 0 OS/20/83 06:46:49
ED LAST LAST LAST DEVICE
ID
RT ACC TA PAM CREATED ACCESSED MODIFIED DUMPED
DJB 2 OS/20/83 OS/20/83 45 1 N RWM 06:45:12 06:45:12
OS/20/83 DD-A2-21 17:08:48
PERMITTED USERS:
USER AM ACC LAST ACCESS CREATED
XYZ RWM 0 05/16/83 12:09:09
ABCD R 0 OS/20/83 06:46:13
QRZX RW 0 OS/20/83 06:46:28
ZILCH E 0 OS/20/83 06:46:49
PDN ID ED LAST LAST LAST DEVICE
SZ RT ACC TA PAM CREATED ACCESSED MODIFIED DUMPED
AUDIT DJB 1 OS/24/83 OS/24/83 DD-Al-22
26467 45 3 N RWM 10:13:33 12:35:30
COSNL DJB 1 04/06/83 04/07/83 OS/20/83 DD-A2-20
1498112 45 3 N RWM 11:28:00 09:41:58 06:05:04
ISAMPL DJB 1 08/11/81 04/22/83 03/03/83 OS/20/83 DD-A2-20 3584 100 24 N RWM 10:07:41 17:21:54 10:02:58 06:04:46
PROFILE DJB 1 04/30/83 OS/24/83 OS/20/83 DD-A2-21
49 45 52 N RWM 14:10:28 10:13:32 06:02:54