List display of operation logs
You can output file access log records or command execution log records as a list or a file by using batch processing.
-
This output processing also outputs file access log records or command execution log records that are backed up by automatic switching or manual switching.
-
The backup files that can be output are those up to the 255th generation.
(1) Operation Log List Display Program (XROPLLST)
Program Name
XROPLLST
Execution parameters (for EXEC statement)
[FILEPUT]
- FILEPUT
-
This parameter is defined to output operation log records to a file.
Define this parameter to output operation log records to a file. Defining this parameter outputs all fields of the operation log records. For details on the format of operation log records, refer to the appendix in Administration Manual.
Defaulting this parameter displays operation log records in a list. For details on the fields that are displayed in a list, refer to Fields that appear in lists.
XRSYSIN Definition Card
This card defines the System Environment Settings of HULFT system. For details on the definitions, refer to the explanation of the System Environment Settings in Administration Manual.
Format of definition card
OPLSELECT=Operation Log Output Option (*1) DATEFMT=Date Format
|
*1 |
: |
When you use the operation log output function, you must include definitions related to operation logs. For details, refer to Definitions for operation logs. |
XRCRD Definition Card
The following shows the format of the definition card for outputting the operation log records as a list.
Format of definition card
a b c d
{FL|CL}[,HOST=xxxx...xxxx][,{USR=xxxx...xxxx|ADMUSR=xxxx...xxxx}]
e f g
[,OP=xxxx...xxxx][,FILE=xxxx...xxxx][,PRCID=xxxx...xxxx]
h
[YMDHMS={yyyymmdd1[-yyyymmdd2]|yyyymmddhhmmss1[-yyyymmddhhmmss2]}]
If the definition card spans two lines, use either of the following two methods to define the definition card:
-
Describe the first line up to column 71, and then insert a hyphen (-) in column 72. Describe the second line starting in column 1.
-
Describe a line up to a comma (,) that follows a parameter, insert a single-byte space, and then insert a hyphen (-) in column 71 or before.
Input contents of definition card
- a. Operation log type
-
This parameter defines the type of the operation log that you want to output as a list or a file. (Mandatory)
- FL:
-
File access log
- CL:
-
Command execution log
- b. Starting host name
-
This parameter defines the starting host names for list display targets. (Optional)
Define an alphanumeric string within 68 bytes for this parameter.
Defaulting this parameter sets all starting host names as targets.
- c. User ID (operating system)
-
This parameter defines the user ID for the operating system on the starting host for list display targets. (Optional)
Define a string within 561 bytes for this parameter. You can use the following characters:
-
Single-byte alphanumeric characters
-
Double-byte uppercase and lowercase alphanumeric characters
-
Half-width Katakana characters
-
Full-width Katakana characters
-
Single-byte spaces
-
Double-byte spaces
If the string contains any of the following, enclose the entire string within double quotation marks (").
-
Single-byte spaces
-
Double-byte spaces
-
Double quotation marks (")
Defaulting this parameter sets all user IDs (operating system) as targets.
You cannot define this parameter together with the User ID (Management Console).
= Remarks =-
Define the user ID for the operating system according to the rules of the operating system on the starting host. For details, refer to the explanation of the operation logs in Administration Manual.
-
When the definition card consists of multiple lines, you do not need to use the double quotation mark (") at the end of the preceding line or at the beginning of the succeeding line.
-
When you use double quotation marks (") for this parameter, use the hexadecimal code '0x7F.'
Depending on the specification for HULFT Character Set (HULCHARSET) in the System Environment Settings, '0x7F' may have been allocated to a character other than the double quotation mark (").
In this case, specify a code that corresponds to '0x7F' as the double quotation mark (").
-
Even if you can use double quotation marks (") for this parameter, this program does not output double quotation marks (") for the Command Parameter in the command execution log records.
-
If you use double quotation marks (") for this parameter, this program may not output operation log records successfully.
-
- d. User ID (Management Console)
-
This parameter defines the user ID for the Management Console Security on the starting host for list display targets. (Optional)
Define an alphanumeric string within 32 bytes for this parameter.
Defaulting this parameter sets all user IDs (management screen) as targets.
You cannot define this parameter together with the User ID (OS).
= Remarks =For details on the user ID for the Management Console Security for each host type, refer to the explanation of the operation logs in Administration Manual.
- e. Operation name
-
This parameter defines the operation name for list display targets. (Optional)
When you define 'FL' for the Operation log type, define a file access type.
When you define 'CL' for the Operation log type, define a command execution key or an operation log search key.
Defaulting this parameter sets all operation names as targets.
= Remarks =-
For details on the file access types that you can define, refer to the appendix in Administration Manual.
-
For details on command execution keys or operation log search keys that you can specify, refer to the appendix in Administration Manual.
-
- f. System file type
-
This parameter defines the system file type for list display targets. (Optional)
You can define this parameter only when you define 'FL' for the Operation log type.
If you define 'CL' for the Operation log type and also define this parameter, an error occurs.
Defaulting this parameter sets all system file types as targets.
= Remarks =For details on system file types that you can define, refer to the appendix in Administration Manual.
- g. Identifier
-
This parameter defines the latest identifier for list display targets. (Optional)
Define a 34-byte alphanumeric string for this parameter.
Defaulting this parameter sets all the latest identifiers as targets.
= Remarks =For details on the identifier, refer to the explanation of the operation logs in Administration Manual.
- h. Date
-
This parameter defines the date and time for list display targets. (Optional)
Define the date in the format that you defined for the Date Format (DATEFMT) in the System Environment Settings.
You can define this parameter in one of the following formats. If you use a format other than the following formats, an error occurs:
-
yyyymmdd1 (*1)
-
yyyymmdd1-yyyymmdd2 (*2)
-
yyyymmddhhmmss1 (*1)
-
yyyymmddhhmmss1-yyyymmddhhmmss2 (*2)
When you define this parameter in one of the formats that are indicated with (*2), yyyymmdd1 must be equal to or earlier than yyyymmdd2 or yyyymmddhhmmss1 must be equal to or earlier than yyyymmddhhmmss2.
Defining this parameter in one of the formats that are indicated with (*1) outputs log records for the dates that are equal to or after the defined date.
Defining this parameter in one of the formats that are indicated with (*2) outputs log records for the dates within the defined date range. In this case, the defined dates are also included in the dates as output targets.
Defaulting this parameter sets log records for all dates as output targets.
= Remarks =-
This program uses the defined dates and times as the execution dates and times to determine log records for output targets.
-
You can define '0' for yyyymmdd1 or yyyymmddhhmmss1. When you define this parameter in this way, the program regards it as defining the oldest date for the log records.
To define '0' for this parameter, you must use a string format with the same length as the number of digits of the date and time.
For example, in order to define '0' for yyyymmddhhmmss, define '00000000000000.'
-
Defaulting this card outputs all operation log records as a list.
Format of output file
This program outputs the file access log records and the command execution log records to a file in the following file formats:
|
|
Operation Log Type 'FL' |
Operation Log Type 'CL' |
|---|---|---|
|
DD Name |
XRFLPUT |
XRCLPUT |
|
File Organization |
Sequential Organization File |
Sequential Organization File |
|
Record Length |
2048 bytes |
2048 bytes |
|
Record Format |
Variable-length blocked format |
Variable-length blocked format |
|
Field Name |
Explanation of Field |
Display Size |
|---|---|---|
|
DATE |
Execution date and time |
23 bytes |
|
PROC-ID |
Latest identifier |
34 bytes |
|
OS-USER |
User ID (operating system) |
105 bytes |
|
ADM-USER |
User ID (management Console) |
32 bytes |
|
HOSTNAME |
Starting host name |
68 bytes |
|
OPERATION |
File access type |
10 bytes |
|
OPERATED FILE |
System file type |
60 bytes |
|
OPERATION-DETAIL |
File key information |
99 bytes |
|
Field Name |
Explanation of Field |
Display Size |
|---|---|---|
|
DATE |
Execution date and time |
23 bytes |
|
PROC-ID |
Latest identifier |
34 bytes |
|
OS-USER |
User ID (operating system) |
105 bytes |
|
ADM-USER |
User ID (Management Console) |
32 bytes |
|
HOSTNAME |
Starting host name |
68 bytes |
|
COMMAND EXEC KEY |
Command execution key |
50 bytes |
|
COMMAND PARAMETER |
Command parameter |
98 bytes |
-
If the field string is less than the display size, the sting is displayed with left alignment.
-
If the field string is more than the display size, the part of the string that exceeds the display size is truncated.
Example of JCL
List display example of file access log
//XROPLLST JOB CLASS=A,MSGCLASS=B //XROPLLST EXEC PGM=XROPLLST //STEPLIB DD DSN=HULFT.LOAD,DISP=SHR //XRSYSIN DD DSN=HULFT.PARMLIB(HULPRM),DISP=SHR //XRCRD DD * FL,HOST=ZOS,USR=USERID,OP=NEW,FILE=HULSND,YMDHMS=YYYYMMDDHHMMSS //XRPRINT DD SYSOUT=* //SYSOUT DD SYSOUT=* //
|
DD Name |
Value |
Description |
|---|---|---|
|
STEPLIB |
HULFT.LOAD |
HULFT load module library |
|
XRSYSIN |
HULFT.PARMLIB(HULPRM) |
System Environment Settings File |
Examples of output lists
File access log
***** FILE ACCESS LOG INFORMATION TABLE ***** 2015.12.01 16:42
PAGE : 1
DATE : 2015/12/01 16:32:32.180 PROC-ID : 7377850DDD8E76A4700000990000010111
HOSTNAME : ZOS13
OS-USER : USR02
ADM-USER : USR02
OPERATION : NEW OPERATED FILE : HULSND
OPERATION-DETAIL : ""FILE0003ZOSTOZOS""
DATE : 2015/12/01 16:32:53.150 PROC-ID : 7377850DDECF6ECDD00000990000010111
HOSTNAME : ZOS13
OS-USER : USR02
ADM-USER : USR02
OPERATION : DELETE OPERATED FILE : HULRHT
OPERATION-DETAIL : ""GRP001-TO-NAGOYA""
DATE : 2015/12/01 16:33:38.320 PROC-ID : 7377850DE181F3B5400000990000010111
HOSTNAME : ZOS13
OS-USER : USR02
ADM-USER : USR02
OPERATION : NEW OPERATED FILE : HULRCV
OPERATION-DETAIL : ""FILE0003ZOSTOZOS""
DATE : 2015/12/01 16:37:48.880 PROC-ID : 7377850DE3304AF0E80000990000010111
HOSTNAME : ZOS13
OS-USER : USR03
ADM-USER : USR03
OPERATION : NEW OPERATED FILE : HULRCVLOG
OPERATION-DETAIL : ""FILE0003ZOSTOZOS"",""ZOS13"",""20151201"",""16340847""
DATE : 2015/12/01 16:37:49.240 PROC-ID : 737784109613A80C7000009E0000010111
HOSTNAME : ZOS13
OS-USER : USR02
ADM-USER : USR02
OPERATION : NEW OPERATED FILE : HULSNDLOG
OPERATION-DETAIL : ""FILE0003ZOSTOZOS"",""ZOS13"",""20151201"",""16340821""
Command execution log
***** COMMAND LOG INFORMATION TABLE ***** 2015.12.01 16:53
PAGE : 1
DATE : 2015/12/01 16:31:56.040 PROC-ID : 7377850DDB6EDAD3D00000990000010111
HOSTNAME : ZOS13
OS-USER : USR02
ADM-USER : USR02
COMMAND EXEC KEY : HULFT_MANAGEMENT_SCREEN_START
COMMAND PARAMETER :
DATE : 2015/12/01 16:32:31.670 PROC-ID : 7377850DDD8E76A4700000990000010111
HOSTNAME : ZOS13
OS-USER : USR02
ADM-USER : USR02
COMMAND EXEC KEY : MANAGEMENT_INFORMATION_REGISTRATION
COMMAND PARAMETER : SNDFILE=FILE0003ZOSTOZOS
DATE : 2015/12/01 16:34:06.160 PROC-ID : 7377850DE3304AF0E80000990000010111
HOSTNAME : ZOS13
OS-USER : USR02
ADM-USER : USR02
COMMAND EXEC KEY : SEND_FILE
COMMAND PARAMETER : FILE-ID=FILE0003ZO
DATE : 2015/12/01 16:35:07.150 PROC-ID : 7377850DE6D2E050E80000990000010111
HOSTNAME : ZOS13
OS-USER : USR02
ADM-USER : USR02
COMMAND EXEC KEY : HULFT_MANAGEMENT_SCREEN_FINISH
COMMAND PARAMETER :
DATE : 2015/12/01 16:41:36.800 PROC-ID : 7377850DFE0C6A8EF00000990000010111
HOSTNAME : ZOS13
OS-USER : USR02
ADM-USER : USR02
COMMAND EXEC KEY : HULFT_MANAGEMENT_SCREEN_START
COMMAND PARAMETER :
Examples of output files
File access log
"2015/12/01","16:32:32.180","2015/09/16","16:32:31.670","USR02","USR02","ZOS13","7377850DDD8E76 A4700000990000010111","7377850DDD8E76A4700000990000010111","ZOS13","","NEW","HULSND","""FILE000 3ZOSTOZOS""" "2015/12/01","16:32:53.150","2015/09/16","16:32:52.710","USR02","USR02","ZOS13","7377850DDECF6E CDD00000990000010111","7377850DDECF6ECDD00000990000010111","ZOS13","","DELETE","HULRHT","""GRP0 01-TO-NAGOYA""" "2015/12/01","16:33:38.320","2015/09/16","16:33:37.960","USR02","USR02","ZOS13","7377850DE181F3 B5400000990000010111","7377850DE181F3B5400000990000010111","ZOS13","","NEW","HULRCV","""FILE000 3ZOSTOZOS""" "2015/12/01","16:37:48.880","2015/09/16","16:34:06.160","N/A","N/A","ZOS13","7377850DE3304AF0E8 0000990000010111","7377850DE3304AF0E80000990000010111","ZOS13","","NEW","HULRCVLOG","""FILE0003 ZOSTOZOS"",""ZOS13"",""20150916"",""16340847""" "2015/12/01","16:37:49.240","2015/09/15","19:47:17.340","USR02","USR02","ZOS13","737784109613A8 0C7000009E0000010111","737784109613A80C7000009E0000010111","ZOS13","","NEW","HULSNDLOG","""FILE 0003ZOSTOZOS"",""ZOS13"",""20150916"",""16340821"""
Command execution log
"2015/12/01","16:31:56.040","2015/09/16","16:31:56.040","USR02","USR02","ZOS13","7377850DDB6EDA D3D00000990000010111","7377850DDB6EDAD3D00000990000010111","ZOS13","","HULFT_MANAGEMENT_SCREEN_ START","HULFT_MANAGEMENT_SCREEN","" "2015/12/01","16:32:31.670","2015/09/16","16:32:31.670","USR02","USR02","ZOS13","7377850DDD8E76 A4700000990000010111","7377850DDD8E76A4700000990000010111","ZOS13","","MANAGEMENT_INFORMATION_R EGISTRATION","HULFT_MANAGEMENT_SCREEN","SNDFILE=FILE0003ZOSTOZOS" "2015/12/01","16:34:06.160","2015/09/16","16:34:06.160","USR02","USR02","ZOS13","7377850DE3304A F0E80000990000010111","7377850DE3304AF0E80000990000010111","ZOS13","","SEND_FILE","HULFT_MANAGE MENT_SCREEN","FILE-ID=FILE0003ZO" "2015/12/01","16:35:07.150","2015/09/16","16:35:07.150","USR02","USR02","ZOS13","7377850DE6D2E0 50E80000990000010111","7377850DE6D2E050E80000990000010111","ZOS13","","HULFT_MANAGEMENT_SCREEN_ FINISH","HULFT_MANAGEMENT_SCREEN","" "2015/12/01","16:41:36.800","2015/09/16","16:41:36.800","USR02","USR02","ZOS13","7377850DFE0C6A 8EF00000990000010111","7377850DFE0C6A8EF00000990000010111","ZOS13","","HULFT_MANAGEMENT_SCREEN_ START","HULFT_MANAGEMENT_SCREEN",""
Points to be noted
-
When you define only the start date and time, the program searches from the beginning and displays file access log records or command execution log records for the execution date and time that matches the start date and time. When the program finds a log record that does not match the start date and time, the program does not display the log record and subsequent log records.
-
When you define the end date and time, the program displays file access log records or command execution log records from the first execution date and time that are equal to or after the specified start date and time to the last execution date and time that does not exceed the end date and time.
