Home

2.0MB

1. A LOG User s Manual 7 13 Chapter 7 A LOG Retention Management Facility 7 4 5 Dump MT Information Information concerning the magnetic tape used by following utilities is called Dump MT information e ALOGJDMP Utility e High Speed Dump Delete Utility e ALOGLDMP Utility Dump MT information is created in a Dump MT Information File in A LOG Management Database during execution of any of the above utilities Dump MT information consists of the following items e Dump Date Execution day of an utility Operation Date e Volume Serial Number Volume serial number of Dump MT all volume serial numbers for a multi volumes Dump MT e Expiration Date Expiration date of the job log or SYSLOG whose expiration date is the highest from among the dumped job logs or SYSLOGs in the Dump MT e Label Number Label number of Dump MT Inquiry Delete using A LOG Terminal Facility Dump MT information can be inquired deleted using 2 2 0 Dump MT Inquiry screen of A LOG Terminal Facility A LOG 2 2 0 DUMP MT INQUIRY 96 09 04 14 16 12 COMMAND gt DUMP DATE VOL SER EXPIRATION LABEL 960831 WORKO3 960904 001 960831 WORKO3 960906 001 kkkkkkkkxk END OF DATA kkkkkkkkk Fig 7 9 Dump MT Inquiry ALOGDLT4 Utility This utility deletes Dump MT information which has passed the retention period Refer to ALOGLDLT4 utility in Chapter 11 A LOG System Utilities for further details 7 14 A LOG User s Manual Chapter 7 A LOG Rete
2. 10 40 A LOG User s Manual Chapter 10 A LOG Terminal Operations Screen Operations Modify Attributes of a Job Log Index Required Item Specification COMMAND Specify SAVE command Specify the new values for the items to be changed and the above command and press ENTER key Attributes of the job log index will be changed accordingly Note Only those items with the gt sign can be changed Request Restoration of a Job Log Required Item Specification COMMAND Specify RESTORE command Specify the above and press ENTER key ALOGJRST utility will be submitted for restoration of the job log The member name specified in MEMBER NAME field of 2 1 0 Job Log Index Maintenance screen is used for submission Note Only when the Storage Place of the job log data is in Dump MT the job log can be restored Reserve Restoration of a Job Log Required Item Specification COMMAND Specify REST ON command Specify the above and press ENTER key The Restore Reservation Flag for the job log will be set to ON Actual restoration of the job log is performed only when ALOGRSEL utility is executed Note Only when the Storage Place of the job log data is in Dump MT the job log can be reserved for restoration Cancel Reservation for Restoration of Job Logs Required Item Specification COMMAND Specify REST OFF command Specify the above and press ENTER key The Restore Reservation Flag for the jo
3. BACK To scroll to previous page of job log data To scroll to upper part of the displayed job log data DOWN To scroll to lower part of the displayed job log data RIGHT To switch to right side of the displayed job log data LEFT To switch to left side of the displayed job log data FIND To search for the specified character string continuously F string start page To search for a specific character strings in the job log data end page To display job log data located on the n page To display job log data located on the page which is n pages before the current page Y 3 o 3 To display job log data located on the page which is n pages after the current page To display job log data from line n To display the line which is n lines before the current line To display the line which is n lines after the current line To display job log data on current page starting from column n onwards Q Q NE 3 z To display job log data on current page starting from the column which is n columns before the current column C n To display job log data on current page starting from the column which is n columns after the current column D data code To display SYSOUT dataset which has the specified data code To display SYSOUT dataset which has sequence number n To display SYSOUT dataset which is n datasets after the currently displayed dataset To display SYSOUT dataset which is n datasets before the curr
4. Print Selection A LOG Management Parameter Database A LOG Terminal Facility a gt WTRJUTL Utility gt e Print Instruction Job Log A LOG Data Pool Listing Fig 5 4 Execution of WIRJUTL Utility 5 6 A LOG User s Manual Chapter 5 A LOG Job Log Print Facility 5 4 2 Utility Functions WTRJUTL utility provides the following functions Selection of Job Logs to be Printed Job logs to be printed can be selected based on the following criteria e Job name e Job log storage date e Job log storage time Selection of Job Log Pages to be Printed The range of pages of a job log to be printed can be selected based on the following criteria e Data code JOBLOG SOUT xxxx e Page range FROM TO Generation of Messages Proof List The following messages proof lists are generated e Print control statement check messages e Job log print messages e Job log listings Generation of Separators The following separators are generated e Job start separator e Job end separator e SYSOUT start separator Refer to WTRJUTL utility in Chapter 11 A LOG System Utilities for further details A LOG User s Manual 5 7 Chapter 6 A LOG SYSLOG Print Facility OS Spool Operating System ALOGSLOG Utility WRITELOG command Resident Program at regular interval Management Database ALOGLDMP Utility A LOG Terminal Facility WTRSUTL AA Utility
5. ZN SYSLOG Audit SYSLOG Index Release File Trail List Fig 11 19 Processing Outline of ALOGLLOG Utility The procedure for executing ALOGLLOG utility is as follows 1 Modify dataset name volume serial number and space requirement for the SYSLOG Index release file in the JCL as required 2 Specify the selection criteria and SYSOUT print option in EXEC parameters and 3 Run ALOGLLOG utility 11 16 3 Input Requirement 1 SYSLOG Index Release File Modify the dataset name volume serial number and space requirement of the SYSLOG Index release file in STEP0010 DDBLOG DD statement of the JCL if necessary A LOG User s Manual 11 61 Chapter 11 A LOG System Utilities 2 EXEC Parameters ALOGLLOG PDATE yymmdd yymmdd POUT YES NO PCODE ALL NOR ERR where PDATE gt Storage Date s Specify a single date yymmdd or a range of dates yymmddyymmdd for selecting SYSLOG indexes based on Storage Date If a date is not specified the current Operation Date is used POUT gt SYSOUT Print Option YES Print SYSOUT to Audit Trail List Default NO Do not SYSOUT PCODE gt Job Completion Code Type ALL Select SYSLOGs with any completion code Default NOR Select SYSLOGs with completion code 0 ERR Select SYSLOGs with completion code not equal 0 11 16 4 Output Listings A sample output listing of SYSLOG Audit Trail List is shown on the following page 11 62 A LOG User s Manual
6. Al Al Al Al Job Log SYSLOG Storage Date Xx Storage Status Number of Pages Job Log SYSLOG Storage Time A Not Yet Stored Return Code Job Name END Storage Ended Message Area Job Number ABEND Storage Abended For ALOGDLT1 utility DUMPED will be displayed constantly For ALOGDMP Job Start Date Storage Place utility DELETE will be displayed for dumped job log and RSTRED will be Job Start Time BKS Stored in A LOG Data Pool displayed for job logs with expired restored retention period which have been deleted lt Job Completion Code DUMP Stored in Dump MT Most Recent Restore Date If a date is displayed in this column it indicates that the particular job log SYSLOG has been restored and deleted A LOG User s Manual 11 9 Chapter 11 A LOG System Utilities 11 7 11 7 1 11 7 2 11 10 ALOGDLT4 Utility Functional Overview ALOGDLT4 utility is used to delete expired records in Dump MT Information File A processing date can be specified in EXEC parameter as a criterion for selecting the records to be deleted If it is not specified the current A LOG Operation Date is used as the processing date Dump MT Information records with expiration date before the processing date will be deleted A list of deleted records or all records in Dump MT Information File an option selectable in the EXEC parameter is output to Dump MT Information Deletion Proof List Processing Requiremen
7. Chapter 1 introduces the components of A LOG system the system facilities and support for multiple CPUs Chapter 2 describes A LOG Master Management Facility It explains the master management functions and ALOGJMST utility Chapter 3 highlights A LOG Job Log Storage Facility It explains storage of job log indexes and data into A LOG database and the ALOGJLOG utility Chapter 4 highlights A LOG SYSLOG Storage Facility It explains storage of SYSLOG indexes and data into A LOG database and the ALOGSLOG utility Chapter 5 introduces A LOG Job Log Print Facility It describes the procedures for printing of job logs using A LOG Terminal Facility and WTRJUTL utility Chapter 6 introduces A LOG SYSLOG Print Facility It describes the procedures for printing of SYSLOGs using A LOG Terminal Facility and WTRSUTL utility Chapter 7 describes A LOG Retention Management Facility It explains the concepts of retention periods calendar date and operation date dumping of job logs and SYSLOGs restoration of job logs and SYSLOGs and deletion of job logs and SYSLOGs Chapter 8 explains A LOG Audit Trail Management Facility Chapter 9 highlights A LOG Monitoring Facility It explains A LOG monitoring functions starting and terminating A LOG Monitor the commands for interacting with A LOG Monitor and recovery management Chapter 10 highlights terminal operations using A LOG Terminal Facility It explains clearly each and every terminal operati
8. Chapter 11 A LOG System Utilities SYSLOG Audit Trail List 03 80 BY BSP INC DATE 96 06 05 A LOG ADVANCED JOBLOG SYSLOG MANAGEMENT SYSTEM VERSION PAGE 1 LIST CODE LOG930 TIME 15 12 39 SYSLOG LISTS JOB NAME JOB NO JOB START SEQ DATA CODE STP M STP P LINE LINE LOG ID PAGE COND LRECL SO CLS CNT PAGE FROM TO 96 06 01 SYSLOG o a H 9 STC00001 001 ve 002 003 SOUT0001 SOUT0002 SOUT0003 J 04 END 121 00007 00016 121 00017 00042 121 00043 00061 END LOG99 004 SOUT0O004 121 00062 00089 96 06 01 1 STC00001 J 01 END 001 00002 00108 96 06 02 1 STC00001 J 02 END 001 00002 00064 002 00065 00065 TOTAL PARAMETER WAS DATE 960601960602 CODE NOR SYSOUT YES amp INPUT RECORD COUNT 0000009 OUTPUT RECORD COUNT 0000009 SYSOUT Sequence Number Number of Lines of SYSOUT SYSLOG Storage Date Storage Status Job Name lt gt Print Status SYSOUT Dataset Code Number of Pages of SYSOUT Job Number x SYSLOG Code RECFM X Contents of Parameter SYSOUT Class lt gt Number of Lines of SYSLOG LRECL amp Number of Input Records Number of Output Records Number of SYSOUT Datasets Number of Pages of SYSLOG O Starting Page Number A LOG User s Manual 11 63 Chapter 11 A LOG System Utilities 11 17 ALOGLRST Utility 11 17 1 Functional Overview ALOGLRST util
9. Chapter 9 A LOG Monitoring Facility 9 3 Caution for Entering Date Before A LOG Version 3 8 any date such as Valid Date Operation Date Storage Date used in A LOG System is in the yymmdd format The year yy component of the date is considered to be the last two 2 digits of the 1900s From A LOG Version 3 8 onwards A LOG file format has been changed to support year 2000 and beyond However the change to this format is limited to the internal processing of A LOG System only The date specified by users is still in yymmdd format This date may be entered from A LOG Terminal Facility or specified in input parameter or command The rule for distinguishing years in the 1900s and the 2000s is as follows 00 lt yy lt 69 means year 20yy 70 lt yy lt 99 means year 19yy For example 931215 is regarded as 15 December 1993 101215 is regarded as 15 December 2010 The date displayed in A LOG Terminal Facility output listings and A LOG messages is still in yymmdd format as usual A LOG User s Manual 9 3 Chapter 9 A LOG Monitoring Facility 9 4 Starting Terminating A LOG Monitor 9 4 1 Starting A LOG Monitor Method To start A LOG Monitor enter the following command from a console S ALOG TYPE WARM COLD e TYPE WARM e TYPE COLD Examples This option sets the Operation Date to be same as the Operation Date of the last operation This is the default This option preve
10. DUMP TAPE INDEX LIST BY SYSLOG DSNAME SYSLOG D960116 LABEL 001 ae o CAT DATE CAT TIME JOB NAME JOB NO 1 S BLOCKS E BLOCKS VOLUME 96 02 01 t 1 rCco0001 1 01 00284 01 00286 BSP216 96 02 02 f I rC00001 I 01 00287 01 00289 BSP216 96 02 03 I rC00001 1 01 00290 01 00292 BSP216 96 02 04 1 rCco0001 1 01 00293 01 00297 BSP216 96 02 05 i 1 rCco0001 1 01 00298 01 00302 BSP216 Dataset Name of Dump MT Storage Status Label Number of Dump MT A Not Yet Stored Sequence Number END _ Storage Ended SYSLOG Storage Date ABEND Storage Abended SYSLOG Storage Time Number of Pages Job Name Y Starting Block Number lt gt Job Number Ending Block Number x SYSLOG ID Volume Serial Number of Dump MT A LOG User s Manual 11 68 Chapter 11 A LOG System Utilities 11 18 ALOGRSEL Utility 11 18 1 Functional Overview ALOGRSEL utility is used to restore the data of job logs and SYSLOGs that have been marked for restoration by users using A LOG Terminal Facility In one execution of the utility either job log or SYSLOG but not both can be restored This utility invokes the respective restore utility ALOGJRST for job log and ALOGLRST for SYSLOG to perform the restoration Job logs SYSLOGs marked for restoration are grouped by the volume serial number label number and dataset name of the Dump MT For each group ALOGRSEL utility generates and submits a job through the internal
11. PRF PRT gt Start Line Number End Line Number Specify the start line number default 1 and end line number default 99999999 to print in 8 digits or less The line number is relative to the SYSLOG data satisfying all the other conditions For example if the SYSLOG data satisfying all the other conditions contains 5000 lines specifying PRF 1 PRT 2000 will print only the first 2000 of these lines Specifying PRF 2001 PRT 99999999 will print lines 2001 to 5000 i Example To print SYSLOG records between 9 a m to 12 p m and containing the string F TSO USERMAX A maximum of 2000 lines are to be printed PRINT SYS SYSLOG MKTMF 090000 MKTMT 120000 SELECT PRMAX 2000 SSTR1 F TSO USERMAX 2 EXEC Parameters WTRSUTL PARM abcccdddddddd where a SYSLOG Print Location Specify one of the following L Line Printer S OSSpool 3 Magnetic Tape b gt must be specified cccc gt 0000 must be specified dddddddd Module name of the SYSLOG Print exit optional A LOG User s Manual 11 81 Chapter 11 A LOG System Utilities 3 DDSPARM Parameter Card This card is specified in DDSPARM DD statement The format is as follows JUTL OUTSEPS YES NO UNIT unit name TIMEC time start pos TCOM time separator JNOC jobno start pos INOL jobno length where OUTSEPS gt SYSLOG Start Separator Print Option YES Print SYSLOG Start separator default NO Do
12. RESTORE COMMAND COMPLETE Processing for restore reservation for restore or cancellation of reservation for restore is completed DUMP MT VOL SER LABEL Volume serial number label number and dataset name of Dump DSNAME UNMATCH ERROR MT for a job log index specified for restoration does not match DATA NOT EXIST IN DUMP MT Storage location of the job log of a job log index marked as R in OP column is not DUMP MT RESTORE EXCEED MAX COUNT Number of job log indexes marked as R in OP column has OF nnn exceeded the maximum number allowed UNMATCH REQUIRED DATA Either the job log index specified for REST ON command has REST ONIREST OFF already been reserved or the reservation of job log index specified for REST OFF command has already been canceled RESTORE JCL MEMBER member JCL member of restore job is missing from the DDWTR ALLOC NOT FOUND statement library of the command procedure for A LOG Terminal Facility A LOG User s Manual 2 1 2 1 Job Log Index No 1 Screen A LOG 2 1 2 1 COMMAND gt JOB NAME JOB NO JOB START DATE START TIME COND CODE PAGE COUNT SYSOUT CLASS JOB CLASS ENTION DAYS STATUS CATLG JOBLOG TIME DESTINATION CODE JOBLOG INDEX NO 1 INQ UPD V3 80ALOG STC01482 960812 185724 0000 000003 1 J 0003 960812 194441 END LOCAL COMMENT gt SYSLOG COMMENT USER COMMENT gt A LOG 2 1 2 2 COMMAND
13. gt yy year mm month dd date For time gt hh hour mm minute ss second If an incorrect operation is performed an error message will be displayed For detail of error message refer to explanation for each screen Screen data display or manipulation area Generally the above screen layout is common for all screens except the Hello A LOG A SPOOL Select and 0 0 0 Initial Menu screens A LOG User s Manual Chapter 10 A LOG Terminal Operations Menu Number Every screen has a menu number except the Hello and A LOG A SPOOL Select screens On the 0 0 0 Initial Menu screen a menu number may be entered for the SELECT item In this case a screen corresponding to the specified menu number will be displayed A menu number may also be entered for the COMMAND item on most of the screens However this is not true for all screens Therefore for those screens where a menu number cannot be entered you should return to 0 0 0 Initial Menu screen and then enter a menu number on this screen The menu numbers that you can enter on a screen are limited to the following e 0 0 0 Initial Menu screen e 1 1 0 Job Log SYSLOG Master Management screen e 2 1 0 Job Log Index Maintenance screen e 2 2 0 Dump MT Inquiry screen e 3 1 0 SYSLOG Data Select screen e 3 2 0 SYSLOG Index Maintenance screen e 9 1 0 Terminal PF Keys Setting screen Screen Commands Screen commands may be entered on a s
14. DDWTR READ ERROR An error has occurred while reading a dataset with DDname DDWTR DDNAME DDWTR CLOSE ERROR _ An error has occurred while closing a dataset with DDname DDWTR JCL STACKER GETMAIN ERROR An error has occurred while allocating storage area of JCLs JCL READ BUFFER GETMAIN An error has occurred while allocating reading area of WTRJCL ERROR JCL STACKER EXCEED MAX COUNT Number of JCL cards has exceeded the maximum number OF nnn allowed DDNAME DDRDR OPEN ERROR An error has occurred while opening a dataset with DDname DDRDR DDNAME DDRDR WRITE ERROR An error has occurred while writing a dataset with DDname DDRDR DDNAME DDRDR CLOSE ERROR An error has occurred while closing a dataset with DDname DDRDR JCL STACKER FREEMAIN ERROR An error has occurred while releasing storage area of JCLs JCL READ BUFFER FREEMAIN An error has occurred while freeing reading area of WTRJCL ERROR THIS JOB EXIST IN DUMP MT Job log data is in Dump MT THIS JOBLOG IS NOT EXIST Job log data does not exist A LOG User s Manual 10 45 Chapter 10 A LOG Terminal Operations 10 46 2 1 4 Job Log Inquiry Screen A LOG 2 1 4 JOBLOG INQUIRY 96 09 04 14 26 44 COMMAND gt JOB V380ALOG JNO STC00345 S DATE 960831 COND 0000 D CODE JOBLOG PAGE F 1 PAGE T 1 CUR 1 LINE 1 COL 1 LRECL 00137 gt ls 422 2 gt 40429 222 pipi pas fai 222 JES2 JOB LOG SYSTEM ESA1 C0034
15. EXEC Parameter E AA Job Log Index SYSLOG Index a HOLTABLE ALOGDLTS pa Master ae Database Job Log Data SYSLOG Data Proof List A LOG Data Pool SYSPRINT DDSCT Job Log SYSLOG DDBKS Index Deletion Fig 11 7 Processing Outline of ALOGDLTS Utility The procedure for executing ALOGDLTS utility is as follows 1 Specify the Processing Date in the EXEC parameter 2 Specify the Holiday Master as required and 3 Run ALOGDLTS utility A LOG User s Manual Chapter 11 A LOG System Utilities 11 8 3 Input Requirement 1 EXEC Parameters ALOGDLT5 PDATE yymmdd where PDATE gt Processing Date Specify the processing date If omitted current A LOG Operation Date is assumed 2 Holiday Master Specification The required Holiday Master is specified in HOLTABLE DD statement as follows HOLTABLE DD DSN holiday master dataset name member name DISP SHR 11 8 4 Output Listing A sample listing of Job Log SYSLOG Index Deletion Proof List is shown on the following page A LOG User s Manual 11 15 Chapter 11 A LOG System Utilities Job Log SYSLOG Index Deletion Proof List A LOG ADVANCED JOBLOG SYSLOG MANAGEMENT SYSTEM VERSION 03 80 BY BSP INC DATE 96 02 14 TIME 14 04 54 JOBLOG INDEX DELETE PROOF LIST EE p gt H o amp CAT DATE JOB NAME JOB NO START DATE TIME END TIME C CODE PAGE RST DATE 96 02 07 ASPLRB14 JOB00074 96 02 07 10 51 33 10 51 45 0000 3 96 02 07
16. Scrolling Up and Down COMMAND Specify UP or DOWN command Place the cursor on the data to be placed on the top line or bottom line of the screen specify the above and press ENTER key Screen Messages INVALID COMMAND An invalid command has been specified INVALID OPERATION An invalid operation code has been specified JAM FILE FIND ERROR RSP xxx An error response code RSP xxx was returned while inquiring into the Job Log Master or SYSLOG Master JAM FILE READ ERROR RSP xxx An error response code RSP xxx was returned while reading the Job Log Master or SYSLOG Master DELETE COMMAND COMPLETE Deletion of job log or SYSLOG master record is completed DELETE COMMAND ERROR RSP xxx An error response code RSP xxx was returned while deleting a job log or SYSLOG master record A LOG User s Manual 10 19 Chapter 10 A LOG Terminal Operations 1 1 2 Job Log SYSLOG Master Screen A LOG 1 1 2 JOB SYSLOG MASTER INQ UPD 96 09 04 14 07 14 COMMAND gt JOB SYSLOG ID JOBLOG VALID DATE 700101 SYSOUT CLASS gt J JOB CLASS gt J ETENTION DAYS gt 0003 RETENTION DAYS gt 0005 DUMP DELETE ESTINATION CODE gt JOB SYSLOG COMMENT gt JOBLOG COMME USER COMMENT gt USER COMMEN LBP INFO gt LBP INFORMATION E PEELE E E Function This screen displays contents of a Job Log or SYSLOG Master record It is used for the following operatio
17. date is greater than TO date DATE ERROR FROM IS BLANK Although the TO date has been specified the FROM date is blank SYSLOG TIME ERROR MUST BE A non numeric time has been specified NUMERIC SYSLOG TIME RANGE ERROR Specified time is not in hhmmss format SYSLOG TIME ERROR FROM gt TO FROM time is greater than TO time SYSLOG TIME ERROR FROM IS BLANK Although the TO time has been specified the FROM time is blank SYSLOG TIME ERROR MUST BE BLANK An invalid print option has been specified Only a blank OR P or P value can be specified SYSLOG ID ERROR An invalid SYSLOG ID has been specified PRINT MAX LINES ERROR MUST NOT BE Maximum print line number is zero or blank ZERO OR BLANK PRINT MAX LINES ERROR MUST BE Maximum print line number is not numeric NUMERIC PRINT MAX LINES ERROR MUST BE Display line number is zero or blank ZERO OR BLANK DISPLAY LINES ERROR MUST BE Display line number is not numeric NUMERIC DISPLAY LINES ERROR FROM gt TO FROM display line number is greater than TO display line number SEARCH STRING ERROR The FIND CHARACTER STRING item has not been specified with a 10 58 A LOG User s Manual Chapter 10 A LOG Terminal Operations 3 1 1 SYSLOG Data Inquiry Screen A LOG 3 1 1 SYSLOG DATA INQUIRY 96 09 04 14 18 00 COMMAND gt LINE gt 00000001 gt 00000100 PRINT MAX LINES gt 99999999 COLUMN
18. e Remaining retention days Retention Period is exceeded and or This is the number of days remaining before the Dump e Keep days This is the number of days a job log should be kept in A LOG Data Pool after storage 3 The maximum number of pages of job log data to be dumped can be specified ALOGJDMP utility will terminate when the total number of pages of job log data dumped reaches the maximum number When ALOGJDMP utility completed normally the data of dumped job logs are deleted from A LOG Data Pool A Dump MT Information record is also created in A LOG Management Database This record contains the following information e Volume serial number of the Dump MT e Dump date e Expiration date of Dump MT and e Tape label number of the Dump MT A list of the dumped job logs is output to Job Log Dump Proof List Notes 1 Restored job log data will not be dumped 2 The maximum number of Dump MTs is 10 11 12 2 Processing Requirement Dump Parameters Holiday Master Dump MTs ALOGJDMP a Utility A LOG Management Database Job Log Dump Job Log Index Dump MT Information EXEC Parameter Job Log Data A LOG Data Pool Fig 11 15 Processing Outline of ALOGJDMP Utility 11 36 A LOG User s Manual Chapter 11 A LOG System Utilities The procedure for executing ALOGJDMP utility is as follows 1 Specify the Dump parameter cards 2 Specify the A AUTO Holiday Master
19. 11 11 4 Output Listings Sample output listings of Holiday Master Maintenance Proof List Holiday Master Inquiry List Card Format and Holiday Master Inquiry List Calendar Format are shown on the following pages A LOG User s Manual 11 31 Holiday Master Maintenance Proof List A LOG ADVANCED JOBLOG SYSLOG MANAGEMENT SYSTEM PROOF LIST OF CALENDAR MASTER 11 11 TL AL 1 1 11 1 11 111 11 E E Lay dL Ll 11 Lo TL ATTE A LOG User s Manual VERSION UPDATION 03 80 BY BSP INC DATE 96 06 07 119702 119703 119704 119705 119706 119707 119708 119709 119710 119711 119712 TIME 13 22 32 LIST CODE Chapter 11 A LOG System Utilities HTO1P 11 32 Holiday Master Inquiry List Card Format A LOG ADVANCED JOBLOG SYSLOG MANAGEMENT SYSTEM CALENDAR INQUIRY LIST HOLIDAY ID ALOGHOL1 11 111111 11 Tal LL 1 11 111 11 11 ay E TT 11 111 111 A LOG User s Manual VERSION 03 80 BY BSP INC DATE 96 06 07 TIME 13 22 32 LIST CODE Chapter 11 A LOG System Utilities HTO20 11 33 Holiday Master Inquiry List Calendar Format A LOG ADVANCED JOBLOG SYSLOG MANAGEMENT SYSTEM CALENDAR HOLIDAY ID ALOGHOL1 1997 01 JANUARY TUE WED THU FRI 1 7 14 15 22 29 APRIL WED THU FRI 1 2 7 8 9 14 15 16 22 23 29 30 JULY WED THU 1 7 8 14 15 21 22 28 29 OCTOBER WED THU
20. 6 3 2 Utility Functions A LOG User s Manual WTRSUTL utility provides the following functions Selection of a range of SYSLOGs to be Printed A range of SYSLOGs to be printed can be selected based on the following criteria e SYSLOG ID mandatory e SYSLOG print start operation date e SYSLOG print end operation date e SYSLOG print start time e SYSLOG print end time Selection of SYSLOG Lines to be Printed Specify lines of a SYSLOG to be printed can be selected based on the following criteria e Job number e Character strings to be searched Maximum Lines to be Printed Specify the maximum number of lines that can be printed based on the following criteria e Maximum line numbers that can be printed e Number of lines per page Generation of Messages Proof List The following messages proof lists are generated e Print control statement check messages e SYSLOG print messages e SYSLOG listings Generation of Separators The following separator is generated e SYSLOG start separator Refer to WTRSUTL utility in Chapter 11 A LOG System Utilities for further details Chapter 7 A LOG Retention Management Facility ALOGDMP1 4 Fast Dump amp Delete of Job Logs fe Dump MT f Y ALOGLRST ALOGRSEL Utilities Restore SYSLOG ALOGJDMP Utility ALOGJRST ALOGRSEL Utilities Restore Dump Job Log Restore Job Log Instruction A 7 i Modify Index Delete Job Log In
21. ALOGBLOG ALOGBLOG Utility Utility AA EAS Job Log Audit SYSLOG Audit Job Log Index Release File SYSLOG Index Release File Trail List Trail List Chapter 8 A LOG Audit Trial Management Facility 8 1 Audit Trail Management 8 1 1 Introduction A LOG Audit Trail Management Facility provides the following audit trail listings showing job log or SYSLOG audit trail information e Job Log Audit Trail List e SYSLOG Audit Trail List The above output listings are generated by ALOGBLOG or ALOGLLOG utility respectively These utilities also create the following user release files e Job Log Index Release File e SYSLOG Index Release File The above release files can be used freely by A LOG users for generating customized audit trail reports A LOG Management Database Job Log Index SYSLOG Index Date Parameter ON Date Parameter pane ALOGBLOG ALOGLLOG Utility Utility AO AAA Job Log Audit SYSLOG Audit Job Log Index Release File SYSLOG Index Release File Trail List Trail List Fig 8 1 A LOG Audit Trail Management Facility A LOG User s Manual 8 1 Chapter 8 A LOG Audit Trial Management Facility 8 1 2 ALOGBLOG Utility ALOGBLOG utility generates Job Log Audit Trail List and creates the Job Log Index Release File based on the information of job log indexes in A LOG Management Database Refer to ALOGBLOG Utility in Chapter 11 A LOG System Utilities for further detail
22. DELETE ERROR Error in specification for Dump Retention HIGHER THAN 5 YEARS Period or Delete Retention Period X98 MAPNAME xxxxxxxx IS NOT DEFINED Undefined map name lt a ERROR CODE xxxxxxxx IS NOT DEFINED Undefined error code Screen Messages INVALID COMMAND An invalid command has been specified A LOG User s Manual Chapter 11 A LOG System Utilities Chapter 11 A LOG System Utilities 11 1 Introduction 11 1 1 Organization This chapter describes A LOG system utilities Each utility is described using the following sections 1 Functional Overview This section describes the functions of the utility The options available and restrictions if any are also described in this section 2 Processing Requirement This section provides an outline of the processing performed by the utility and describes the procedure for the proper execution of the utility 3 Input Requirement This section describes the required input for the utility such as control cards parameter specifications input datasets etc 4 Output Listings This section provides a sample of each output listing generated by the utility 11 1 2 Relationship Between A LOG Monitor And System Utilities Some A LOG system utilities require A LOG Monitor to be active before they can be executed Some require A LOG Monitor to be inactive Yet others are independent of A LOG Monitor The table below shows the system utilities and their relati
23. HASP373 V380ALOG STARTED C0034 IEF403I V380ALOG STARTED TIME 15 26 06 C0034 SSB103I ASPPRM1 SYSTEM PARAMETER WAS C0034 ASPL MAJOR USMSV242 SPMMN SPMXV 88 C0034 ASPL SVC 242 SPMDB 88 C0034 ASPL OS MVS ESA JES JES2 C0034 ASPL WTODESC 8 WTOROUT 15 C0034 ASPL MAXLC 180 MAXLL 304 C0034 ASPL DBTYPE ABSUSER COMPRESS YES C0034 ASPL MODE MULTI ACTIVATE GROBAL C0034 SSB111I ACTIVE MODE MULTI C0034 SSB110I PARAMETER WAS SET AS A GLOBAL SYSTEM C0034 SPM003I COLD START OPTION ASSIGNED C0034 SPM004A A LOG WAITING FOR DATE COMMAND C0034 SPM0011A LOG IS ACTIVE C00345 39 SPMOO9A A LOG 85 SPOOL UTILIZATION C0034 SPM011I OPERATOR TYPED IN DATE 960801 Function This screen displays the job log data It is used for the following operations e Scrolling of job log data e Searching for specific character strings e Displaying of job log data in HEX format e Displaying of job log data in CHAR format Screen Commands MENU To switch to 0 0 0 Initial Menu screen XEXIT To terminate A LOG Terminal Facility To switch to 2 1 1 1 Job Log Directory 2 1 1 2 Job Log Directory or 2 1 3 Job Log Index No 2 screen HEX o To display job log data in HEX mode To display job log data in CHARACTER mode To display first page of job log data A LOG User s Manual Chapter 10 A LOG Terminal Operations BOTTOM The display last page of job log data NEXT To scroll to next page of job log data
24. Handling of SYSLOG at Time of Abend In this situation shown above SYSMO00 and SYSMO0O001 have been stored into A LOG database before the abend A SYLOG index reflecting that storage of SYSMO00 and SYSMO0O1 is created Therefore inquiry to the SYSLOG can be performed However the Storage End Date and Storage End Time of SYSLOG index will be blank When ALOGSLOG utility is rerun a new SYSLOG index is created and storage of the SYSLOG shall resume and shall continue from SYSM0002 which was being stored when ALOGSLOG abended earlier After completion of storage of each SYSLOG dataset inquiry of the SYSLOG dataset can be performed as normal A LOG User s Manual 9 15 Chapter 9 A LOG Monitoring Facility 9 6 3 Abend of A LOG Monitor Actions by Users Determine the cause of error for the abend of A LOG Monitor by referring to A LOG Messages amp Codes Manual Restart A LOG Monitor If ALOGJLOG utility has ended Rerun ALOGJLOG utility If ALOGJLOG utility is still active Cancel ALOGJLOG utility using OS cancel command Then rerun ALOGJLOG utility If ALOGJLOG utility is requesting processing from A LOG Monitor while it has abended ALOGJLOG utility will display message SCT206E and end with RSP 148 If A LOG Monitor has abended after ALOGJLOG has requested processing from it ALOGJLOG utility will be left waiting for a reply from A LOG Monitor If ALOGSLOG utility has ended Rerun ALOGSLOG utility If ALOGSLOG util
25. Modify the dataset name of the library that contains the sample restore job in the DDJCL DD statement if necessary 3 Create the sample restore job into the library specified in 2 if necessary and 4 Run ALOGRSEL utility 11 18 3 Input Requirement 1 ALOGRSEL Parameter Card Specify the ALOGRSEL parameter card in DDCNTL DD statement The format is as follows RESTSEL KEEPI index ret KEEPD data ret JOBNM member MODE JLOG SLOG where KEEPI gt After Restore Index Retention Period Specify the number of days between 0 1830 to retain the index after restoration If i omitted the value is calculated based on the Delete Retention Period or previous After Restore Index Retention Period Refer to Chapter 7 for more information i KEEPD gt After Restore Data Retention Period Specify the number of days between 0 1830 to retain the data after restoration E Default value is 0 F JOBNM Member Name Specify the member name of the sample restore job If omitted the member name E ALOGJRST for job log or ALOGLRST for SYSLOG is used MODE gt Job Log SYSLOG Selection JLOG Select job logs only Default SLOG Select SYSLOGs only 11 70 A LOG User s Manual Chapter 11 A LOG System Utilities 2 Modify Sample Restore Job Library Dataset Name Modify the dataset name of the library that contains the sample restore job This library is usually A LOG Parameter Library The library is specifi
26. R 002 003 004 LOG LOG LOG LOG LOG LOG LOG LOG 960808 960809 960810 960811 960812 960813 960814 960815 END OF DATA 960808 134559 960809 090354 960810 104636 960808 172459 960811 005401 960809 200814 960810 210436 960811 105211 DUMP MT 960812 125124 DUMP MT ON BKS BKS BKS BKS BKS 960812 024144 960813 003341 960814 003341 960815 003341 KKKKKKKKKK 960813 115149 960814 093951 960815 164441 Fig 7 21 SYSLOG Directory Screen RESTORE command can also be entered on 3 2 2 1 SYSLOG Index or 3 2 2 2 SYSLOG Index screen In this case it restores only the SYSLOG currently displayed on the screen A LOG 3 2 2 1 COMMAND gt SYSLOG INDEX NO 1 INQ UPD 96 09 04 14 20 24 JOB NAME JOB NO JOB START DATE START TIME SYSLOG STC00001 LOG DATE SYSLOG ID JOB END DATE END TIME 950815 SYSLOG ll PAGE COUNT SYSOUT CLASS JOB CLASS RETENTION DAYS DUMP CATLG START DATE START TIME STATUS CATLG DESTINATION CODE SYSLOG COMMENT USER COMMENT 000269 LINE COUNT 5 DATASET COUNT R 0003 00032385 010 ou il RETENTION DAYS DELETE CATLG END DATE END TIME STATUS PLACE 0003 960816 090354 END 960816 104047 DUMP MT tou ou ou gt gt Fig 7 22 SYSLOG Index Screen A LOG User s Manual Chapter 7 A LOG Retention Management Facility 7 6 4 Restore Reservat
27. SALEJ200 and SALEJ300 RESTORE RID SALEJ100 MAKED 970115 MAKET 094538 INDEX NO KEEPD 1 KEEPI 3 RESTORE RID SALEJ200 MAKED 970115 MAKET 101855 INDEX NO KEEPD 1 KEEPI 3 RESTORE RID SALEJ300 MAKED 970115 MAKET 103415 INDEX NO KEEPD 1 KEEPI 3 Example To list the contents of a Dump MT volume RESTORE LIST YES 2 USMSJRST Parameter Card Specify the USMSJRST parameter card in USMSCARD DD statement The format of this card is as follows USMS UNIT unit name where UNIT gt Unit Device Name of the Dump MT Specify the device name of the Dump MT that contains the job log s to be restored This is required only if INDEX NO or no INDEX keyword is specified in the restore parameter card and the Dump MT is to be dynamically allocated default is TAPE 3 Dump MT Specification If the index of the job log to be restored has been deleted from A LOG Management Database or when a Dump MT Inquiry List is to be generated the Dump MT information must be specified in DDIN DD statement Example DDIN DD DSN ALOG D950801 DISP OLD PASS UNIT TAPE VOL SER C95134 LABEL 1 SL 11 14 4 Output Listings Sample output listings of Job Log Restore Proof List and Dump MT Inquiry List are shown on the following pages 11 52 A LOG User s Manual Chapter 11 A LOG System Utilities Job Log Restore Proof List A LOG ADVANCED JOBLOG SYSLOG MANAGEMENT SYSTEM VERSION 03 80 BY BSP INC DATE 96 02 14 T
28. VVVVVV RESTORE JOB CONTROL MEMBER NAME gt DATA RETN DAYS gt INDEX RETN DAYS gt Function This screen is displayed when 2 1 is specified in SELECT item of 0 0 0 Initial Menu screen or when 1 is specified in SELECT NUMBER item of 2 0 0 Job Log Management screen It is used to specify the selection criteria for selecting job logs for maintenance It is used for the following operations e Inquiry Update of job log indexes e Deletion of job logs e Printing of job logs e Restoration of job logs A LOG User s Manual 10 25 Chapter 10 A LOG Terminal Operations Flow of Job Log Index Maintenance Screens The following figure shows the flow of job log index maintenance screens Legend 2 1 0 Job Log Index ENTER Key Maintenance O Code in OP Column XXxx Command 2 1 1 1 2 1 1 2 Job Log Job Log Directory Directory Oy NEXT 2 1 2 1 Error Message Job Log Inquiry Fig 10 6 Screen Flow of Job Log Index Maintenance Function Screen Commands MENU To switch to 0 0 0 Initial Menu screen XEXIT To terminate A LOG Terminal Facility EXIT To switch to 2 0 0 Job Log Management screen To switch to menu screen corresponding to the specified menu number 10 26 A LOG User s Manual Chapter 10 A LOG Terminal Operations Input Output Items Length 1 SELECT Alphabetic Select one of the following function code
29. lt gt Word Text 31 Alphanumeric Specify the search criteria 20 Parameter 51 Numeric Specify the starting column position of the parameter text Column 3 as specified in item yc Parameter 54 Numeric Specify the length of the parameter text as specified in item Length 3 Or Alphanumeric Specify the parameter text 10 Specify the starting column position of the data 3 Data Length Specify the length of the data 3 A LOG User s Manual 3 11 Chapter 3 A LOG Job Log Storage Facility Format amp Item Name Col Length Description Data Format 73 Alphanumeric Specify comment for format of data to be collected Comment 8 Keywords of Job Log Message Definition Cards The keywords of a job log message definition card is shown as follows oie oema Ooo usr marat n id OO Eoma l oenen O O oo Ceni o Jaen mara Coo o osm mar Cas ee bara Homer 0 nenas Ser oe ems CCA MEC TUTTO AO Deon ECON TOTO ie O E ame E am o eres O Ceneo onran eroon O OOOO OO ESTIU svsovteamin J Notes 1 When multiple occurrences of JOBST Message ID is displayed in the job log the time from the first message is set 2 When multiple occurrences of JOBET Message ID is displayed in the job log the time from the last message is set 3 COND code with the maximum value is set A LOG User s Manual Chapter 3 A LOG Job Log Storage Facility Example Specification of a Job Log Message defi
30. paa which cannot be displayed KANJI CODE Alphabetic Specify the Kanji code to be used by the terminal I IBM J JEF K KEIS MAX BUFFER LEN Numeric Specify the maximum buffer length to be used for transmission of data to the terminal Default value is 4096 bytes when 00000000 is specified PF 01 PF 24 og Alphabetic Specify a command Screen Operations For each PF to be set or changed override the current setting if any and press ENTER key The new settings become effective immediately until the end of the session of A LOG Terminal Facility To set or change the settings permanently until the next change specify SAVE command and press ENTER key The following commands are used by A LOG Terminal Facility e BACK e BOTTOM e DELETE e DOWN e EMSG e EXIT e FIND e LEFT e MENU e NEXT e PRINT e RIGHT e SAVE e TOP e UP e XEXIT Screen Messages INVALID COMMAND An invalid command has been specified CALLED SCREEN NOT FOUND The function associated with the specified menu number is not available PF KEYS SETTING SAVED PF KEY has been set NO MAP TO SAVE The map to be updated does not exist MAP NAME NOT MATCHED The map name to be updated does not match MAP LIBRARY STOW ERROR Attempt to update map library has failed n n n CALLED SCREEN LOAD ERROR An error has occurred during loading of menu module with menu number n n n A LOG User s Manual Chapter 10 A LOG Terminal Operations 10 9 Terminal Error Me
31. 001 LINE NO 00000001 SYSLOG ID SCH DATE 960805 960905 SYSLOG TIME 135720 141720 2 lose pas iS SS scR ese Sl ae SSeS DS SS ID 0000000 NAME 93289 eas 00000010 IEF196I 1EF2371 JES2 0000000 NAME 93289 34 00000010 EF196I IEF285I JES 0000000 NAME 93289 34 7 SYSLOG 00000000 EE042I SYSTEM LOG DA 0002000 NAME 93289 34 A STC02934 01000010 LLLLLL AJS004E JCL MA 0002000 NAME 93289 34 STC02934 01000010 LLLLLL AJSOO5I DDNAME 0002000 NAME 93289 34 STC02934 01000010 AML902I LJS HA 0002000 NAME 93289 34 STC02934 01000010 AML903I TERMIN 0002000 NAME 93289 34 STCO2934 01000010 AML9O5I LMP LO 4000000 NAME 93289 234 01000010 IEEO43I A SYSTEM LOG R4000000 NAME 93289 34 STC02934 01000010 IEF404I AUTLMCP6 EN 4000000 NAME 93289 da 7 STC02934 01000010 HASP395 AUTLMCP6 END 0000000 NAME 93289 34 A 00000010 IEA989I SLIP TRAP ID 0002000 NAME 93289 234 lt STC02932 01000010 GGGGGG AMCO221 FINAL 0002000 NAME 93289 234 STC02932 01000010 GGGGGG AMC903I GOOD B R4000000 NAME 93289 34 STC02932 01000010 IEF404I AUTO60 ENDE 4000000 NAME 93289 234 STC02932 01000010 HASP395 AUTO60 END 0000000 NAME 93289 234 00000010 IEA989I SLIP TRAP ID R4000000 NAME 93289 234 7 JOB02945 01000010 IEF404I G86ANATB EN O 0000000000000000 0 2222az zza zaza zaanza 22 Ae eee zaa ee Bee zaza Function This screen displays the SYSLOG data It is used for the follo
32. 10 9 Terminal Error Messages oooconoccnnoccnoncnnnconccnnncnnnnnnncnnnnonanonancnn a ieas 10 81 Chapter 11 A LOG System Utilities 11 LD Introduccion lada ia 11 1 11 2ALOGBLOG Util S 11 2 TS ALOGCHKA UOY reiese eii e alte Beet a 11 5 ITA ALOGCHKE Utility cnech e e ee a a a a 11 6 IESALOGDATE UUUY ui tal ii dis de E atin oot 11 7 11 6 ALOGDE TT Util uta iia iii dead 11 8 11 7 ALOGDETG UI 3 tesa nite a hat naaa 11 10 T13 ALOGDE TS Util satis eras A aie ee aa 11 13 11 9 ALOGDMPE Utility issn teciinie akg ih ee a ss 11 17 11 10 High Speed Dump amp Delete Utilities o oonnoccnnccnocanocaconacono ce ceeseeeneeenaes 11 20 TELAT ALOGHOLT Ulit inene ane chistes shoe sisted coving 11 29 11 12 ALOGJDMP Utility 2 nines ca ied a 11 35 1115 ALOGIMS ET Otty eeinetan ahente eer ae a oi e aaeeei 11 42 11 14 ALOGIRST UHH aini cecal anes asas 11 50 11 15 ALOGLDMP Utility cucian en Gite en eke es eee 11 55 ii A LOG User s Manual Table of Contents Chapter 11 A LOG System Utilities 11 16 AE GGLEOG UGH oa taa 11 61 11 17 ALOGERST Utility tetona aie austin eet edie dee its 11 64 IVS ALOGRSEL Util Y eiee eentenari iae e Ea riis 11 69 11 19 WTRJUTE UY 2 icon a Pae EEEIEE ti 11 73 11 20 W TRSUTL Utd vid 11 79 Suggestion Page List of Figures Fig 1 1 Components of A LOG System oooocccnccnccnconconconconocacnncnoncnnoness 1 1 Fig 1 2 Multi CPU Job Log Management using JESMAS IBM 1 6 Fig 1 3 Multi CPU J
33. 111 111 111 111 111 111111111 SSSSSSS SS Ss SSS SSS Ss Ss S SSS SSS S SS SS SSS SSS SS S SSSSSSSS 00000000 UUUU UUUU TITITITITITIT 000000 000000 000000 000 000 TT 00 00 00 00 00 00 000 000 TT 00 000 00 000 00 000 000 000 TT 000 0 000 000 0 000 000 0 000 1 000 000 CT 000 0 000 000 0 000 000 o 000 000 000 CT 000 0 000 000 0 000 000 0 000 000 000 CT 000 0 000 000 O 000 000 0 000 000 000 17 000 00 000 00 000 00 000 000 17 00 00 00 00 00 00 00000000 000000 000000 000000 111 1111 1 111 111 111 111 111 111 111 111111111 CAT DATE START DATE COND CODE PRINT DATE 96 02 10 96 02 10 COND 0000 96 02 10 SYSOUT CLS J CAT TIME START TIME COMMENT PRINT TIME FORM CODE JES2 JOB01318 PS0101 16 39 50 JOB NAME 16 39 38 END DATE JOB LOG COMMENT 12 08 30 STD ASPASM 96 02 10 JOB NUMBER JOB01318 END TIME 16 39 43 PAGE COUNT LINE COUNT DSNAME A LOG User s Manual 11 78 Chapter 11 A LOG System Utilities 11 20 WTRSUTL Utility 11 20 1 Functional Overview WTRSUTL utility is used to print SYSLOGs Options are available to e Print the SYSLOG records for a specific job e Select the range of dates and times to print e Select the range of lines to print e Specify the maximum number of lines to print e Specify whether to print SYSLOG Start separator 11 20 2 Processing Requirement Print Selection DDSPARM Parameter Parameter Zig WTRSUTL Uti
34. 19 1 018 27 61 12 3 1 1 Number of Lines of SYSOUT 2 Number of Pages of SYSOUT 3 Content of Parameter 4 Number of Input Records 5 Number of Output Records 11 4 Chapter 11 A LOG System Utilities 113 ALOGCHKA Utility 11 3 1 Functional Overview ALOGCHKA utility is used to check that A LOG Monitor is active It will terminate when A LOG Monitor is active Otherwise the following message is displayed SSB101I ALOG IS NOT ACTIVE Checking is repeated every 10 seconds and the above message is displayed until A LOG Monitor is active 11 3 2 Processing Requirement ALOGCHKA ALOG Utility Monitor Fig 11 2 Processing Outline of ALOGCHKA Utility To execute ALOGCHKA utility simply run the utility A LOG User s Manual 11 5 Chapter 11 A LOG System Utilities 11 4 ALOGCHKL Utility 11 4 1 Functional Overview ALOGCHKL utility is used to check that A LOG Monitor is inactive It will terminate when A LOG Monitor is inactive Otherwise the following message is displayed SSB102I ALOG IS ACTIVE Checking is repeated every 10 seconds and the above message is displayed until A LOG Monitor is terminated 11 4 2 Processing Requirement ALOGCHKL ALOG Utility Monitor Fig 11 3 Processing Outline of ALOGCHKL Utility To execute ALOGCHKL utility simply run the utility 11 6 A LOG User s Manual Chapter 11 A LOG System Utilities 11 5 ALOGDATE Utility 11 5 1 Functional Overview
35. 2 1 0 Job Log Index Maintenance screen Print Job Logs Perform print instructions using A LOG 2 1 1 1 2 Job Log Directory screens Print SYSOUT Perform print instructions using A LOG 2 1 3 Job Log Index No 2 screen Print Specific Pages of SYSOUT Specify the range of pages to be printed in the PAGE FROM TO items on A LOG 2 1 3 Job Log Index No 2 screen The specified range must be within the limits as displayed on the screen for the SYSOUT Specify Writer Submission by Job Specify whether to submit writer by job in the WRITER SUBMISSION BY JOB item on A LOG 2 1 0 Job Log Index Maintenance screen as follows e N Print multiple job logs collectively e Y gt Print one job log at a time If N is specified one execution of WTRJUTL utility will print all job logs marked with value P in OP column of A LOG screens If Y is specified WTRJUTL is submitted for each job log marked with value P in OP column of A LOG screens Figures 5 2 and 5 3 provides further information on the impact of the above specification Refer to Chapter 10 A LOG Terminal Operations for further details A LOG User s Manual 5 3 Chapter 5 A LOG Job Log Print Facility ASPASM JOB00100 Job Start Separator Job Log If n job logs are marked for printing all the marked job logs will be printed in one DA execution of WIRJUTL utility JOB00100 Job End Separator 7 a a ONO sc
36. 7 14 21 28 A LOG User s Manual INQUIRY VERSION 03 80 BY BSP INC DATE 96 06 07 02 FEBRUARY 1997 TUE WED 2 3 9 10 17 24 05 MAY TUE WED 4 5 11 12 18 19 25 26 31 THU 4 11 18 25 1997 08 AUGUST SUN MON TUE WED 2 3 4 9 10 11 16 17 18 23 24 25 30 31 THU 5 12 19 26 1997 11 NOVEMBER SUN MON TUE WED 1 2 3 8 9 10 15 16 17 22 23 24 29 30 THU 4 11 18 25 TIME 13 22 32 LIST CODE 03 MARCH TUE WED THU 2 3 4 9 10 Ed 16 17 18 23 24 25 30 31 06 JUNE TUE WED 1 2 8 9 16 23 30 09 SEPTEMBE TUE WED THU 1 2 7 8 9 14 15 16 21 22 23 28 29 30 12 DECEMBER TUE WED THU 1 2 7 8 9 14 15 16 22 23 29 30 Chapter 11 A LOG System Utilities HT020 R FRI 3 10 FRI 3 10 17 24 31 11 34 Chapter 11 A LOG System Utilities 11 12 ALOGJDMP Utility 11 12 1 Functional Overview ALOGJDMP utility is used to dump job logs that have exceeded the Dump Retention Period to a magnetic tape called Dump MT Both the job log index and data are dumped This utility provides the following functions 1 A processing date can be specified in the EXEC parameter as a criterion for selecting job logs to be dumped If it is not specified the current A LOG Operation Date is used as the processing date A job log will be dumped if it satisfies the following condition Job Log Storage Date Dump Retention Pe
37. A LOG utility is still active To force terminate A LOG Monitor enter the following command from console F ALOG FSTOP Examples To terminate A LOG Monitor properly P ALOG SPMO11I OPERATOR TYPED IN SSTOP SPM305I WRITER LOGX WAS CLOSED SPMOO8I ALOG IS TERMINATED JEM3951 ALOG ENDED To force terminate A LOG Monitor F ALOG FSTOP SPMO11I OPERATOR TYPED IN FSTOP SPM305I WRITER LOGX WAS CLOSED SPMOO8I ALOG IS TERMINATED JEM3951 ALOG ENDED A LOG User s Manual 9 5 Chapter 9 A LOG Monitoring Facility 9 5 A LOG Monitor Commands 9 5 1 DATE Command Function To set the Operation Date for operations of A LOG System Command Syntax F ALOG DATE yymmdd e yymmdd This variable specifies the Operation Date If omitted the CPU date at the time of command input is used as the Operation Date Example Operator enter F ALOG DATE A LOG messages displayed on console SPM0111 OPERATOR TYPED IN DATE SPM202I CURRENT DATE SET TO 96 10 14 SPM200I START UP DATE PROCESSOR SPM2011 FINISH DATE PROCESSOR SPM305I WRITER LOGX WAS CLOSED SPM3041 WRITER LOGY WAS SELECTED A LOG User s Manual Chapter 9 A LOG Monitoring Facility 9 5 2 DSPACE Command Function To display the database space utilization of A LOG Management Database and A LOG Data Pool Command Syntax F ALOG DSPACE Example Operator enter F ALOG DSPACE A LOG messages displayed on console SP
38. A LOG Management Database restoration of the SYSLOG can be performed by any method If the SYSLOG index has been deleted from A LOG Management Database restoration of the SYSLOG can be only performed by ALOGLRST utility Restore SYSLOGs by ALOGLRST Utility Specify the SYSLOGs to be restored in a restore parameter and execute ALOGLRST utility The following specific component s can be specified as the option for restoration e SYSLOG index only e SYSLOG data only e Both SYSLOG index and data Restore SYSLOGs by Instruction from A LOG Terminal Facility Restore SYSLOGs by selecting the SYSLOGs and specifying RESTORE command using 3 2 1 SYSLOG Directory or 3 2 2 1 2 SYSLOG Index screen of A LOG Terminal Facility In this case only SYSLOG data is restored Restore SYSLOGs by Reservation from A LOG Terminal Facility Reserve SYSLOGs for restoration by selecting the SYSLOGs and specifying REST ON command using 3 2 1 SYSLOG Directory or 3 2 2 1 2 SYSLOG Index screen of A LOG Terminal Facility Then execute ALOGRSEL utility to restore the reserved SYSLOGs In this case only SYSLOG data is restored A LOG User s Manual 7 25 Chapter 7 A LOG Retention Management Facility 7 6 2 ALOGLRST Utility ALOGLRST utility can be used to restore dumped SYSLOGs from a Dump MT back into A LOG Management Database and A LOG Data Pool USMSLRST Restore A LOG Management Database Parameter Parameter USMSCARD DDCNTL DDIN __ gt ALOGLRST
39. ALOGLRST utility will be submitted for restoration of the SYSLOG The member name specified in MEMBER NAME field of 3 2 0 SYSLOG Index Maintenance screen is used for submission Note Only when the Storage Place of the SYSLOG data is in Dump MT the SYSLOG can be restored N Reserve Restoration of a SYSLOG Required Item Specification COMMAND Specify REST ON command Specify the above and press ENTER key The Restore Reservation Flag for the SYSLOG will be set to ON Actual restoration of the SYSLOG is performed only when ALOGRSEL utility is executed Note Only when the Storage Place of the SYSLOG data is in Dump MT the SYSLOG can be reserved for restoration Cancel Reservation for Restoration of a SYSLOG Required Item Specification COMMAND Specify REST OFF command Specify the above and press ENTER key The Restore Reservation Flag for the SYSLOG will be set to OFF A LOG User s Manual 10 75 Chapter 10 A LOG Terminal Operations Screen Messages INVALID COMMAND An invalid command has been specified DATA CHECK ERROR An error has been detected in the content of an item in SYSLOG index DATA SET STORE EXCEED MAX COUNT Number of datasets in a SYSLOG has exceeded the OF nnn maximum number allowed RESTORE COMMAND COMPLETE Processing for restore reservation for restore or cancellation of reservation for restore is completed DATA NOT EXIST IN DUMP MT Storage location of the SYSLOG for RE
40. AUTOSFIN JOB00075 96 02 07 10 51 48 10 51 55 0000 10 96 02 07 ALOGLDMP JOBO00076 96 02 07 10 52 02 10 52 56 0000 2 96 02 07 AJOBO001 JOB00077 96 02 07 10 52 42 10 52 45 0000 ak 96 02 07 AJOBO0002 JOB00078 96 02 07 10 52 26 10 52 49 0000 96 02 07 IEBCOPY JOB00079 96 02 07 10 53 05 10 53 45 0000 96 02 07 AUTOAMSO JOBO0080 96 02 07 10 53 10 10 53 21 0000 96 02 07 XGENER JOB00081 96 02 07 10 53 12 10 53 42 0000 1 2 3 4 5 6 F 8 Sequence Number Job Log SYSLOG Storage Date Job Name Job Number Job Start Date Job Start Time lt gt Job End Time x Job Completion Code Number of Pages of Job Log SYSLOG Most Recent Restore Date If a date is displayed in this column it indicates that the specific job log SYSLOG has been restored and deleted A LOG User s Manual 11 16 Chapter 11 A LOG System Utilities 11 9 ALOGDMPC Utility 11 9 1 Functional Overview ALOGDMPC utility is used to make a copy of a Dump MT The copy of Dump MT is referred to as the Dump Copy MT The Dump Copy MT is identical to the original Dump MT except for the Dump MT information in the job log SYSLOG indexes The Dump MT information i e volume serial number tape label number start block pointer and tape dataset name in the Dump Copy MT are that of the Dump Copy MT ALOGDMPC utility does not update the job log SYSLOG indexes in A LOG Management Database with the Dump Copy MT information Hence these indexes still contain the original
41. DATA NOT EXIST IN DUMP MT Storage location of the SYSLOG of a SYSLOG index marked as R in OP column is not DUMP MT RESTORE EXCEED MAX COUNT OF nnn Number of SYSLOG indexes marked as R in OP column has exceeded the maximum number allowed UNMATCH REQUIRED DATA REST Either the SYSLOG index specified for REST ON ONI REST OFF command has already been reserved or the reservation of SYSLOG index specified for REST OFF command has already been canceled RESTORE JCL MEMBER member NOT JCL member of restore job is missing from the DDWTR FOUND ALLOC statement library of the command procedure for A LOG Terminal Facility 10 70 A LOG User s Manual Chapter 10 A LOG Terminal Operations 3 2 2 1 SYSLOG Index Screen A LOG 3 2 2 1 SYSLOG INDEX NO 1 INQ UPD 96 09 04 14 20 24 COMMAND gt JOB NAME SYSLOG LOG DATI 960815 JOB NO STC00001 SYSLOG I SYSLOG JOB START DATE JOB END START TIME EN PAGE COUNT 000269 LINE COUNT 00032385 SYSOUT CLASS 5 DATASET COUNT 010 JOB CLASS gt R ENTION DAYS gt 0003 RETENTION DAYS 0003 DELETE 960816 CATLG END DATE 960816 TIME 090354 END TIME 104047 STATUS CATLG END STATUS PLACE DUMP MT DESTINATION COD SYSLOG COMMENT gt USER COMMENT gt 3 2 2 2 SYSLOG Index Screen A LOG 3 2 2 2 SYSLOG INDEX NO 1 INQ UPD 96 09 04 14 21 19 COMMAND
42. DATE TIME 960831 152605 JOB NO STCO0345 END DATE TIME 960831 152652 COND CODE 0000 DATE 960105 DATA CODE RECFM RECL PAGE FROM TO LINES PAGES JOBLOG FM 000001 000001 00000174 000001 souTo101 FA 000002 000002 00000009 000001 SOUT0103 FA 000003 000003 00000024 000001 KKKKKKKK k k kkkkkk k KKKKKK kkkkx k Function This screen displays the SYSOUT Attribute Information of the Job Log index It is used for the following operations e Printing of each SYSOUT dataset e Display the data of each SYSOUT dataset Screen Commands To switch to 0 0 0 Initial Menu screen To switch to 2 1 2 1 Job Log Index No 1 screen To scroll up one page To serol upone page o O ror Todisplayfirtpageofdatacodo o To display last page of data code To print job log by SYSOUT dataset A LOG User s Manual 10 43 Chapte 10 44 r 10 A LOG Terminal Operations Input Output Items JOB NAME RA Job name is displayed JOB START Job start date time yymmdd hhmmss format DATE TIME displayed JOB NO gono oee Job number is displayed JOB END Job end date time yymmdd hhmmss format is DATE TIME displayed COND CODE CONDCODE Job completion code is displayed LOG DATE pf e Job log storage date is displayed Alphanumeric Specify one of the following operation codes B Browse SYSOUT dataset P Print SYSOUT dataset msc If print command has been specifie
43. Data Required Item Specification lop Specify D for the SYSLOGs to be deleted COMMAND Specify DELETE command Specify the above and press ENTER key Before performing these instructions you must have specified D in for the SELECT FUNCTION item in 3 2 0 SYSLOG Index Maintenance screen Request Restoration of SYSLOGs Required Item Specification lop Specify R for the SYSLOGs to be restored COMMAND Specify RESTORE command Specify the above and press ENTER key ALOGLRST utility will be submitted for restoration of the SYSLOGs The member name specified in MEMBER NAME field of 3 2 0 SYSLOG Index Maintenance screen is used for submission Upon successful submission of ALOGLRST utility the message RST will be displayed in the MSG column of the SYSLOGs Notes 1 Only when the Storage Place of the SYSLOG data is in Dump MT the SYSLOG can be restored 2 If the dataset name label and first volume serial number of the Dump MT of all the selected SYSLOGs are the same up to a maximum of 100 SYSLOGs can be restored A LOG User s Manual Chapter 10 A LOG Terminal Operations 3 Reserve Restoration of SYSLOGs Required Item Specification lop Specify R for the SYSLOGs to be reserved for restoration COMMAND Specify REST ON command Specify the above and press ENTER key The Restore Reservation Flag for the SYSLOG will be set to ON Actual restoration of the SYSLOG is performed onl
44. Dump MT information In order to retrieve or restore a job log SYSLOG data from the Dump Copy MT follow the procedure below 1 Delete the index of the job log SYSLOG to be restored from A LOG Management Database 2 Then restore the job log S YSLOG index and data from the Dump Copy MT gt eae _ B Utility Copy MT 11 9 2 Processing Requirement Copy MT Proof List Fig 11 8 Processing Outline of ALOGDMPC Utility The procedure for executing ALOGDMPC utility is as follows 1 Specify the volume serial numbers of the Dump MT and Dump Copy MT in EXEC parameters and 2 Run ALOGDMPC utility A LOG User s Manual 11 17 Chapter 11 A LOG System Utilities 11 9 3 Input Requirement The EXEC parameters for ALOGDMPC utility ALOGDMPC INVOL volserl OUTVOL volser2 where INVOL Volume Serial Number of Dump MT OUTVOL gt Volume Serial Number of Dump Copy MT To change the dataset name unit name or tape label of the Dump MT or Dump Copy MT modify the DDUT1 for input Dump MT or DDUT2 for Dump Copy MT DD statements as required 11 9 4 Output Listing A sample output listing of Dump Copy MT Proof List is shown on the following page 11 18 A LOG User s Manual Chapter 11 A LOG System Utilities Dump Copy MT Proof List A LOG ADVANCED JOBLOG SYSLOG MANAGEMENT SYSTEM VERSION 03 80 BY BSP INC DATE 96 06 08 TIME 15 22 15 PROOF LIST OF DUMP COPY JOBLOG LIST CODE DMP200 J k
45. Fig 7 12 Job Log Index Maintenance Screen A LOG User s Manual 7 19 Chapter 7 A LOG Retention Management Facility 2 On 2 1 1 1 Job Log Directory or 2 1 1 2 Job Log Director screen enter RESTORE command after specifying R in the OP column of the job log s to be restored A LOG 2 1 1 1 JOBLOG DIRECTORY INQ UPD 96 09 04 14 COMMAND gt RESTORE OP MSG DATE JOB NAME JOB NO S DATE S TIME E TIME PAGE Q JOBI R 960105 V380ALOG STCO00345 960831 152605 152652 0003 960105 V380ALOG STC00352 960831 152724 154415 0003 960107 V380ALOG STC00420 960831 155034 161129 960107 V380ALOG STC00487 960831 161742 162118 960107 V380ALOG STC00495 960831 162130 163529 960812 V380ALOG STC00731 960812 132948 133659 960812 V380ALOG STC00758 960812 133754 184431 960812 V380ALOG STC01482 960812 185724 190231 960813 V380ALOG STC00247 960813 100341 122621 960813 V380ALOG STC01326 960813 171248 200230 960819 V380ALOG STCO1607 960819 214535 220110 960819 V380ALOG STC0O1737 960819 235353 010055 KKKKKKKKKK END OF DATA XX X Xxxx PRBOUOUQCQUGQRPRRPEE SELECT B BROWSE P RESTORE REST ON REST OFF Fig 7 13 Job Log Directory Screen RESTORE command can also be entered on 2 1 2 1 Job Log Index No 1 or 2 1 2 2 Job Log Index No 1 screen In this case it restores only the job log currently displayed on the screen A LOG 2 1 2 1 JOBLOG INDEX NO 1 INQ UPD 96 09 04 14 11 55 COMMAND gt RESTORE
46. Index File SYSOUT Data Entire Job Log Entire SYSOUT _P Delete Proof List Fig 7 7 Fast Dump Delete Utilities Processing Outline A LOG User s Manual 7 11 Chapter 7 A LOG Retention Management Facility 7 4 4 ALOGLDMP Utility ALOGLDMP utility is an utility for dumping SYSLOGs which have passed the specified retention period into a Dump MT DMPSYS A LOG Management Database Parameter EXEC DDCNTL Parameters Holiday tel ee ALOGLDMP Master Utility DDOUT SYSPRINT SYSLOG Dump A LOG Data Pool Proof List Fig 7 8 ALOGLDMP Utility Processing Outline Refer to ALOGLDMP utility in Chapter 11 A LOG System Utilities for further details ALOGLDMP utility provides the following functions Check Retention Period It calculates the last day of the retention period of every SYSLOG based on the storage date of the SYSLOG and the Dump Retention Period specified in SYSLOG index It then selects the SYSLOGs which have passed the retention period and dump the SYSLOGs to a Dump MT The SYSLOGs which have been restored once cannot be dumped again Reference to a Holiday Master is required under the following conditions e When the Dump Retention Period is less than or equal to 29 days or e When reference to Holiday Master is specified in EXEC parameter The reference date for checking whether the retention period has passed can be specified in the EXEC parameter If the
47. JCLs After Restore Index Retention Period and After Restore Data Retention Period on 3 2 0 SYSLOG Index Maintenance screen If the specified member name does not exist in the library a default member ALOGLRST of the same library will be submitted The execution job name at the time of submission is replaced by the specified member name The job name SYSLOG storage date and SYSLOG storage time are set automatically in the restore parameter of ALOGLRST utility Usage Procedure 1 Specify member name of JCLs After Restore Index Retention Period and After Restore Data Retention Period of ALOGLRST utility in 2 0 SYSLOG Index Maintenance screen as shown below SYSLOG INDEX MAINTENANCE 96 09 04 14 18 35 gt FUNCTION gt FUNCTION De DELETE BLANK INQUIRY UPDATE LECT KEYS SYSLOG ID SCH DATE RESTORE JOB CONTROL MEMBER NAME gt ALOGLRST DATA RETN DAYS gt 0001 INDEX RETN DAYS gt 0002 Fig 7 20 SYSLOG Index Maintenance Screen A LOG User s Manual Chapter 7 A LOG Retention Management Facility 2 On 3 2 1 SYSLOG Directory screen enter RESTORE command after specifying R in the OP column of the SYSLOG s to be restored A LOG 3 2 1 SYSLOG DIRECTORY INQ UPD 96 09 04 14 19 29 COMMAND gt RESTORE OP SEQ LOGID R 001 LOG SCH DATE 960807 CATALOG START DATE TIME 960807 125520 CATALOG END DATE TIME 960807 145820 PLACE DUMP MT RSTR
48. JOB NAM JOB NO DUMP DSNAME VOL SER LABEL ESTORE REQUEST ESTORE DATE ESTORED DATA RETENTION DAYS USER COMM LOG DAT JOBLOG I JOB END EN LINE COUNT DATASET COUNT RETENTION DAYS DELETE CATLG END DATE END TIME STATUS PLACE JOBLOG INDEX NO 1 INQ UPD V3 80ALOG STC01482 ALOG V0380 JDMP ALOGO1 0001 ON gt 0000 LOG DATE JOBLOG ID RESTORE STATUS RESTORED INDEX Chapter 10 A LOG Terminal Operations 96 09 04 14 11 55 960812 JOBLOG 960812 190231 00000204 002 gt 0003 960812 194454 DUMP MT 96 09 04 14 15 36 960812 JOBLOG RETENTION DAYS gt A LOG User s Manual 10 37 Chapter 10 A LOG Terminal Operations 10 38 Function These screen display the Job Attribute Information of the Job Log index The 2 1 2 1 Job Log Index No 1 and 2 1 2 2 Job Log Index No 1 screens may be displayed by using UP and DOWN commands respectively These screens are used for the following operations e Modify attributes of a job log index e Request restoration of a job log e Reserve restoration of a job log e Cancel reservation for restoration of a job log Screen Commands MENU To switch to 0 0 0 Initial Menu screen XEXIT To terminate A LOG Terminal Facility EXIT To switch to 2 1 1 1 Job Log Directory or 2 1 1 2 Job Log Directory screen SAVE To update job log index NEXT
49. JOB NAME V380ALOG LOG DATE 960812 JOB NO STCO1482 JOBLOG ID JOBLOG JOB START DATE 960812 JOB END DATE 960812 START TIME 185724 END TIME 190231 COND CODE 0000 PAGE COUNT 000003 LINE COUNT 00000204 SYSOUT CLASS 1 DATASET COUNT 002 JOB CLASS gt J RETENTION DAYS gt 0003 RETENTION DAYS 0003 DUMP DELETE CATLG START DATE 960812 CATLG END DATE 960812 START TIME 194441 END TIME 194454 STATUS CATLG END STATUS PLACE DUMP MT DESTINATION CODE LOCAL JOBLOG COMMENT gt SYSLOG COMMENT USER COMMENT gt USER COMMENT Fig 7 14 Job Log Index Screen A LOG User s Manual Chapter 7 A LOG Retention Management Facility 7 5 4 Restore Reservation from A LOG Terminal Facility Reservation for restoration of job logs can be performed from A LOG Terminal Facility A REST ON command from A LOG Terminal Facility will set the Restore Reservation Flag to ON This command is applicable only to those job logs with DUMP MT as the current Storage Location Restoration of the job logs is performed only when ALOGRSEL utility is executed Refer to 7 5 4 ALOGRSEL Utility for further details Usage Procedure 1 On 2 1 1 1 Job Log Directory or 2 1 1 2 Job Log Directory screen enter REST ON command after specifying R in the OP column of the job log s to be reserved for restore To cancel reservation for a restore enter REST OFF command after specifying R in the OP
50. LETE 960930 ASDO81 001 960929 LETE 960930 ASDO82 001 960930 LETE 960930 ASDO83 002 960929 LETE 960930 ASDO84 001 960930 LETE 960930 ASDO85 002 960930 LETE 960930 ASDO86 001 961001 LETE 960930 ASDO87 002 961001 LETE 961003 ASDO11 002 961002 LETE 961004 ASDO21 001 961003 LETE 961004 ASDO22 002 961003 LETE Reference Date for Deletion Sequence Number Date Dumped by Dump Utility Volume Serial Number of Dump MT Label Number of Dump MT The highest expiration date among the job logs SYSLOGs dumped into Dump MTs lt gt Execution result of Dump MT Information Delete Utility A LOG User s Manual 11 12 Chapter 11 A LOG System Utilities 11 8 ALOGDLTS Utility 11 8 1 Functional Overview ALOGDLTS utility is used to delete the index and data of expired job logs and SYSLOGs A processing date which is a criterion for determining whether a job log SYSLOG has expired can be specified in EXEC parameter If it is not specified the current A LOG Operation Date is used as the processing date A list of the deleted job log SYSLOG indexes are output to the Job Log SYSLOG Index Deletion Proof List The formula for determining whether a job log SYSLOG is expired depends on whether the job log SYSLOG is restored or not as follows 1 For job log SYSLOG Index that is not restored Storage Date Delete Retention Period lt Processing Date 2 For job log SYSLOG Index that is restored Last Restore Date After Rest
51. Maintenance Setting 1 1 1 2 1 1 1 2 3 1 1 3 2 1 Job Log SYSLOG Job Log SYSLOG SYSLOG Master Directory Directory Data Inquiry Directory 1 1 2 3 2 2 1 2 Job Log SYSLOG SYSLOG Master Index Job Log Inquiry Chapter 10 A LOG Terminal Operations 10 1 Screen Organization A LOG Terminal Facility is a fully menu driven facility Generally the screens of A LOG Terminal Facility is organized as follows 0 0 0 Initial Menu 1 0 0 Job Log SYSLOG Master Management 1 1 0 Job Log SYSLOG Master Maintenance 1 1 1 Job Log SYSLOG Master Directory 1 1 2 Job Log SYSLOG Master A LOG User s Manual 2 0 0 Job Log Management 2 1 0 2 2 0 Job Log Index Dump MT Maintenance Inquiry 2 1 1 1 2 Job Log Directory 2 1 2 1 2 Job Log Index No 1 2 1 3 Job Log Index No 2 3 0 0 SYSLOG Management 3 1 0 SYSLOG Data Select 3 1 1 SYSLOG Data Inquiry 3 2 0 SYSLOG Index Maintenance 3 2 1 SYSLOG Directory Fig 10 1 Screen Organization 9 0 0 System Management 9 1 0 Terminal PF Keys Setting 10 1 Chapter 10 A LOG Terminal Operations 10 2 10 2 Key Functions Master Management Function This function is used to register modify delete and inquire records of the following A LOG master files e Job Log Master e SYSLOG Master Job Log Management Function This function is used to manage job logs with the following ope
52. PARAMETER WAS 74 INPUT RECORD COUNT 5 OUTPUT RECORD COUNT x Job Log Storage Date Job Name Job Number Job Start Date Job Start Time A LOG User s Manual ADVANCED JOBLOG SYS Is TS JOB START SEQ DATA CODE ES Eh JOB00099 96 06 01 001 SOUT0001 002 SOUT0002 003 SOUT0003 004 SOUT0004 JOB00136 96 06 02 09 SCT00347 001 96 06 02 12 SOUT0001 JOB00977 001 96 06 02 19 SOUT0001 JOB00451 001 002 96 06 03 14 SOUT0001 SOUT0002 0000013 0000013 Job End Time lt Job Completion Code x SYSOUT Class lt Number of SYSOUT Datasets Storage Status LOG MANAGEMENT SYSTEM 10 00 19 kkk VERSION 03 80 COND LRECL gt 10 06 41 FA 121 Z FA FA 121 FA 121 00007 00043 00062 09 0000 J 432 0000 J FA 133 09 0000 FA 133 09 0000 FA 133 FA 121 DATE 960601960603 SYSOUT YES CODE NOR Print Status O Job Log ID Number of Lines of Job Log Number of Pages of Job Log SYSOUT Sequence Number SO CLS CNT PAGE FROM TO H 0000 J 00 BY BSP INC DATE 96 06 05 STP M STP P amp ve 15 END 00016 X 121 Y 00017 00042 00061 00089 EN EN SYSOUT Dataset Code lt YRECFM te LRECL Starting Page Number Ending Page Number TIME 15 12 39 LOG ID Chapter 11 A LOG System Utilities PAGE 1 LIST CODE LOG910 LINE PAGE LINE PAGE 2 830 82 307 10 1 970 2 535
53. Processing Requirement Holiday Master Definition Cards ALOGHOLT Holiday Master Utility Holiday Master Holiday Master Holiday Master Maintenance Inquiry List Inquiry List Proof List Card Format Calendar Format Fig 11 14 Processing Outline of ALOGHOLT Utility The procedure for executing ALOGHOLT utility is as follows 1 Specify the Holiday Master definition cards and 2 Run ALOGHOLT utility 11 11 3 Input Requirement Specify the Holiday Master definition cards in SYSIN DD statement The format of these cards is as follows Cl orate _ _ gt O A LOG User s Manual 11 29 Chapter 11 A LOG System Utilities es ou ee Calendar Alphanumeric This area is used to specify the holidays in a calendar Information month It is required when registering or updating Holiday Master information Each column represents a day in a month The first column corresponds to the first day of a month the second column corresponds to the second day of the month and so on To mark a particular day as a holiday specify 1 in the corresponding column Otherwise specify a blank Also specify an E in the column just after the last day of the month For example if April 7 is the only holiday in that month specify 1 in column 7 E in column 31 since there are 30 days in April and blanks in all other columns Processing Type da Specify one of the followin
54. To switch to 2 1 3 Job Log Index No 2 screen SYSOUT attribute information EMSG To switch to Error Message screen To switch to 2 1 2 1 Job Log Index screen To switch to 2 1 2 2 Job Log Index screen RESTORE To restore job logs REST ON To reserve job logs for restoration REST OFF To cancel reservation of job log restoration Input Output Items tem Length Format Description JOB NAME O se EL Job name is displayed LOG DATE Job log storage date A LOG operation date is displayed JOB NO LJOBNO Job mumberis displayed Job number is displayed LNOBLOGID 2 Job log ID is displayed JOB STARTDATE fob star dae is displayed JOBENDDATE tobeniducisdimplyed A LOG User s Manual Chapter 10 A LOG Terminal Operations tem Length Format Description srme o rosarina C eNDTIME O 2 ooo Job end time is displayed jconpcope tobcompletioncodisdisplayed PAGECOUNT Number of pages of job tog is displayed inecount Number of tines ofjob log is displayed lsvsourctass SYSOUT class is displayed DATASETCOUNT NumberofSYSOUT datasets in job log is displayed JOB CLASS 1 Alphanumeric Job class of job log is displayed This item may be modified RETENTION DAYS 4 Numeric Dump Retention Period is displayed This item may DUMP be modified by specifying a value between 0000 to 1830 This item is not applicable
55. Utility NE SYSPRINT SYSLOG Restore Dump MT A LOG Data Pool Proof List Proof List Fig 7 19 ALOGLRST Utility Processing Outline Refer to ALOGLRST utility in Chapter 11 A LOG System Utilities for further details ALOGLRST utility offers the following functions Select SYSLOGs for Restoration SYSLOGs to be restored can be selected by specifying the selection criteria in the restore parameter The following selection criteria are supported By job name By SYSLOG ID By SYSLOG storage date By SYSLOG storage time Assign Dump MT for Restoration The Dump MTs to be used for restoration of SYSLOGs is automatically assigned from the SYSLOG indexes of those SYSLOGs specified in restore parameter The maximum number of SYSLOGs that can be restored in one execution of ALOGLRST utility is 100 A Dump MT is a dataset containing the SYSLOGs dumped by one execution of ALOGLDMP utility A LOG User s Manual Chapter 7 A LOG Retention Management Facility Restore SYSLOG Data SYSLOG data is restored from Dump MT back into A LOG Data Pool Restore SYSLOG Index Option It can be specified in a restore parameter whether the SYSLOG index of the SYSLOG is to be restored If SYSLOG index is to be restored the Dump MT must be specified in DDIN DD statement of the execution JCLs Set Restore Information ALOGLRST utility sets the following information in SYSLOG index e Restore status e Restore date e After Resto
56. VALID DATE 700101 SYSOUT CLASS gt J JOB CLASS gt J RETENTION DAYS gt 0003 RETENTION DAYS gt 0005 DUMP DELETE DESTINATION CODE gt JOB SYSLOG COMMENT gt JOBLOG COMMENT USER COMMENT gt USER COMMENT LBP INFO gt LBP INFORMATION EERE A E E A eg tare A A E A A Fig 2 2 Job Log Master Registration JOBLOG SYSLOG ID This item defines an identifier for a Job Log Master record Specify a value up to 8 alphanumeric characters for this item VALID DATE This item defines the effective date of a Job Log Master record Specify a valid date in yymmdd format for this item Note that a Job Log Master record is uniquely identified by its Job Log ID and Valid Date SYSOUT CLASS This item defines the output class of a Job Log Master record It is used by A LOG System when performing Immediate Print during storage of a job log Specify an alphanumeric character for this item JOB CLASS This item defines the job class of a Job Log Master record It is used for selection of job logs Specify an unique alphanumeric character for this item Note that this item has no relationship with the SYSOUT CLASS item A LOG User s Manual Chapter 2 A LOG Master Management Facility H RETENTION DAYS DUMP This item defines the Dump Retention Period i e the number of days a job log is to be retained in A LOG database before it is being dump by ALOGJDMP utility Specify a 4 digit number
57. and data and delete job log data Delete job logs indexes and data The correlation between the status retention periods and utilities for retention management of job logs or SYSLOG is shown in Fig 7 4 A LOG User s Manual Chapter 7 A LOG Retention Management Facility Status of Valid Utility Job Log or Retention SYSLOG Period ALOGJDMP ALOGLDMP ALOGDLT1 ALOGDLTS ALOGDMP1 ALOGDMP2 ALOGDMP3 Dump Retention o o O Before Period Holiday Holiday Holiday Restore Delete Retention Oo o o Oo Oo Period RETN RETN Holiday RETN Holiday After Restore Index Retention i y a Holiday Holiday After ero Restore After Restore Data Retention Period Legend O The indicated valid retention period is referred Holiday Holiday Master is referred refer to 7 3 Calendar Date and Working Date for further details RETN Delete Retention Period is referred for calculating remaining retention days which is compared with RETN keyword of DMPJOB or DMPSYS parameter The indicated valid retention period is not referred Fig 7 4 Correlation between Retention Period amp Utilities 7 2 3 Specification Methods for Retention Periods The specification methods for the different types of retention periods are given as follows Dump Retention Period This retention period is specified in Job Log or SYSLOG Master The specified value is also kept in job log or SYSLOG index when the job log or SYSLO
58. any one time The JCLs for submitting ALOGJRST utility must be defined in a library a standard library is A LOG Parameter Library This library must be specified in DDWTR DD statement of the command procedure of A LOG Terminal Facility Specify JCL member name After Restore Index Retention Period and After Restore Data Retention Period on 2 1 0 Job Log Index Maintenance screen If the specified member name does not exist in the library a default member ALOGJRST of the same library will be submitted The execution job name at the time of submission is replaced by the specified member name The job name job log storage date and job log storage time are set automatically in the restore parameter of ALOGJRST utility Usage Procedure 1 Specify JCL member name After Restore Index Retention Period and After Restore Data Retention Period of ALOGJRST utility in the screen as shown below A LOG 2 1 0 JOBLOG INDEX MAINTENANCE 96 09 04 14 09 05 COMMAND gt SELECT FUNCTION gt FUNCTION SELECT KEYS rp DELETE BLANK INQUIRY UPDATE LOG DATE gt 960905 JOB NAME gt JOBLOG ID gt SELECT KEY OF COND CODE JOB CLASS gt COND CODE gt vr EQUAL START DATE gt G GREATER OR EQUAL START TIME L LESS OR EQUAL FROM gt N NOT EQUAL TO gt WRITER NAME gt WRITER SUBMISSION BY JOB gt RESTORE JOB CONTROL MEMBER NAME gt ALOGJRST DATA RETN DAYS gt 0001 INDEX RETN DAYS gt 0002
59. as required 3 Specify the Dump MT volume serial number processing date and the option to reference A AUTO Holiday Master in EXEC parameters and 4 Run ALOGJDMP utility 11 12 3 Input Requirement 1 Dump Parameter Cards These cards are specified in DDCNTL DD statement Each card has the following format DUMP keyword value keyword value Each card must begin with DUMP in column 1 Multiple keyword value pairs can be specified on one card by coding them one after another separated by commas Format amp Keyword Length Description Alphanumeric Specify JOBLOG 6 Alphanumeric Specify the jobname of the job log to be dumped A maximum of 100 jobnames may be specified in one JOB keyword Note that the job log is dumped only if the Dump Retention Period is exceeded JD Numeric Specify the job number of the job log to be dumped A maximum of 100 1 8 job numbers may be specified in one JID keyword Note that the job log is dumped only if the Dump Retention Period is exceeded RETN Numeric Specify the remaining retention days for selecting job logs to be dumped 1 4 The remaining retention days is the number of days remaining before the Dump Retention Period is exceeded It is calculated as follows Remaining Retention Days Storage Date Dump Retention Period Processing Date RETN can be specified in one of the following formats e RETN nnnn Dump the job log if Remaining Retention Days for the jo
60. be restored If job log index is to be restored the Dump MT must be specified in DDIN DD statement of the execution JCLs Set Restore Information ALOGJRST utility sets the following information in job log index e Restore status e Restore date e After Restore Index Retention Period as specified in restore parameter e After Restore Data Retention Period as specified in restore parameter Output Restore Proof List An output listing of showing the restored job logs is generated Output Dump MT Inquiry List An output listing of the Dump MT Inquiry List can be requested However output of a Dump MT Inquiry List and the job log restore proof list cannot be performed at the same time Refer to 7 5 7 Dump MT Inquiry List for further details A LOG User s Manual Chapter 7 A LOG Retention Management Facility 7 5 3 Restore Instruction from A LOG Terminal Facility Restoration of job logs can be performed immediately from A LOG Terminal Facility A RESTORE command from A LOG Terminal Facility will submit ALOGJRST utility automatically to restore the selected job logs immediately This command is applicable only to those job logs with DUMP MT as the current Storage Location If the dataset name label number first volume serial number of the Dump MT are the same for several selected job logs these job logs can be restored together in one single execution of ALOGJRST utility A maximum of 100 job logs can be restored at
61. can be reserved for restoration A LOG User s Manual Chapter 10 A LOG Terminal Operations x Cancel Reservation for Restoration of Job Logs Required Item Specification OP Specify R for the job logs for which reservation for restoration are to be canceled COMMAND Specify REST OFF command Specify the above and press ENTER key The Restore Reservation Flag for the job log will be set to OFF Search for Specific Job Name COMMAND Specify F job name Specify the above and press ENTER key If the specified job name is found it will be displayed on the first line To continue searching for the next line with the same job name specify FIND command and press ENTER key Screen Messages INVALID COMMAND An invalid command has been specified INVALID OPERATION An invalid operation code has been specified FIND STRING NOT FOUND Unable to find the job name specified in F command in the directory list PRINT OPERATION COMPLETE Printing of job log is completed DDNAME DDWTR OPEN ERROR An error has occurred while opening a dataset with DDname DDWTR WTRNAME ruvoer NOT FOUND DDNAME DDWTR READ ERROR An error has occurred while reading a dataset with DDname DDWTR DDNAME DDWTR CLOSE ERROR An error has occurred while closing a dataset with DDname DDWTR JCL STACKER GETMAIN ERROR An error has occurred while allocating storage area for JCLs JCL READ BUFFER GETMAIN An error has oc
62. described below A LOG User s Manual 11 43 Chapter 11 A LOG System Utilities 11 44 Format of Data Area of Card ID 0 Format amp Item Name Col Length Description Job Log 7 Alphanumeric Specify Job Log SYSLOG ID SYSLOG ID 8 Valid Date Specify the valid date in yymmdd format 6 Job Class Alphanumeric Specify the job class 1 Immediate Print 22 Alphanumeric Specify the output class for the immediate printing of the Output Class job log after storing it This item is a comment for SYSLOG Dump Retention 23 Numeric Specify the number of days to retain the job log SYSLOG Period 4 data in A LOG Data Pool before dumping it to tape Delete Retention 27 Numeric Specify the number of days to retain the job log SYSLOG Period 4 in A LOG Management Database before deleting it DEST Code 31 Alphanumeric Specify the destination code This item is treated as a 8 comment in this version of A LOG Format of Data Area of Card ID 1 Format amp Item Name Length Description Immediate Print oa T Specify the immediate print criteria This item is treated as Criteria a comment in this version of A LOG Format of Data Area of Card ID 2 Format amp Item Name Length Description Job Log Alphanumeric Specify the job log SYSLOG comment SYSLOG Comment Format of Data Area of Card ID 3 Format amp Item Name Col Length Description Alphanumeric Specify the user comment 64 A LOG User s M
63. dynamically allocated default is TAPE 3 Dump MT Specification If the index of the SYSLOG to be restored has been deleted from A LOG Management Database or when a Dump MT Inquiry List is to be generated the Dump MT information must be specified in DDIN DD statement Example DDIN DD DSN ALOG D950801 DISP OLD PASS UNIT TAPE VOL SER C95134 LABEL 1 SL 11 17 4 Output Listings Sample output listings of SYSLOG Restore Proof List and Dump MT Inquiry List are shown on the following pages 11 66 A LOG User s Manual Chapter 11 A LOG System Utilities SYSLOG Restore Proof List A LOG ADVANCED JOBLOG SYSLOG MANAGEMENT SYSTEM VERSION 03 80 BY BSP INC DATE 96 02 14 TIME 10 21 53 PROOF LIST OF RESTORE SYSLOG LIST CODE RST100 J DSN SYSLOG D960116 dk x o o CAT DATE CAT TIME JOB NAME 1 STT M LABEL VOLSER 96 02 01 04 05 01 I TC00001 1 BSP216 96 02 02 08 16 51 I TC00001 I BSP216 Dataset Name of Dump MT SYSLOG Storage Date SYSLOG Storage Time Job Name Job Number SYSLOG ID lt gt Number of Pages H Storage Status A Not Yet Stored END Storage Ended ABEND Storage Abended 9 Label Number of Dump MT Volume Serial Number of Dump MT A LOG User s Manual 11 67 Chapter 11 A LOG System Utilities Dump MT Inquiry List A LOG ADVANCED JOBLOG SYSLOG MANAGEMENT SYSTEM VERSION 03 80 BY BSP INC DATE 96 02 14 TIME 22 27 11
64. e Inquiry e Print Instruction Fig 4 1 A LOG SYSLOG Storage Facilit A LOG User s Manual Chapter 4 A LOG SYSLOG Storage Facility 4 2 SYSLOG Index A SYSLOG index is created by ALOGSLOG utility when a SYSLOG is stored into A LOG database The creation of the SYSLOG index is based on master record defined in SYSLOG Master The SYSLOG Master record to be referenced is specified in DDSCNTL parameter of ALOGSLOG utility Refer to 4 4 ALOGSLOG Utility for further details The log date for the SYSLOG index to be created is derived from operation date Operation date is established by one of the followings e By ALOGSLOG utility when it is started or e By DATE command Note It is important to note that the log date of a SYSLOG index and the CPU date of a SYSLOG may be different Therefore if the operation dates before and after the entry of DATE command are different the log dates of the SYSLOG indexes for the SYSLOGs with the same CPU date will be different A LOG Terminal Facility can be used to perform inquiry on SYSLOG indexes A SYSLOG index consists the information as shown in A LOG 3 2 2 1 and A LOG 3 2 2 2 screens as follows A LOG 3 2 2 1 SYSLOG INDEX NO 1 INQ UPD 96 11 04 14 20 24 COMMAND gt JOB NAME JOB NO JOB START DATE START TIME SYSLOG LOG DATE STC00001 SYSLOG ID JOB END DATE END TIME 961015 SYSLOG tou ou ou tou ou ou PAGE COUNT SYSOUT CLASS JOB CLASS gt R RETENTION DAYS 0
65. e Print Instruction Chapter 6 A LOG SYSLOG Print Facility 6 1 Introduction There are two methods of printing SYSLOGs managed by A LOG System e Print by instruction from A LOG Terminal Facility e Print by submitting WTRSUTL utility These are highlighted in the following diagram Operating System ALOGSLOG Utility WRITELOG command Resident Program at regular interval OS Spool SYSLOG A LOG Data Pool Management Database ALOGLDMP Utility A LOG Terminal Facility TSO TSS y WTRSUTL gt Utility LLN e Print Instruction SYSLOG Listing Fig 6 1 A LOG SYSLOG Print Facility A LOG User s Manual 6 1 Chapter 6 A LOG SYSLOG Print Facility 6 2 Print From A LOG Terminal Facility Print instruction may be issued from a terminal for the printing of SYSLOGs using A LOG Terminal Facility In this case WTRSUTL utility will be submitted to print the SYSLOGs If the SYSLOGs to be printed are stored in Dump MT a tape mount request will automatically be issued on console for mounting of the Dump MT There are four instructions for printing SYSLOGs using A LOG Terminal Facility These are described as follows Specify a Writer Name Specify a writer name on A LOG 3 1 0 SYSLOG Data Select screen If a writer name is not specified the member named WTRSUTL in A LOG JCL Library is used as the default If a writer name is specified the specified writer name is used as a job n
66. in HEX format Display of SYSLOG Data in CHAR Format By default SYSLOG data will be displayed in CHAR format unless HEX command has been entered as described in To revert back to display in CHAR format do the following Required Item Specification COMMAND Specify CHAR command Specify the above and press ENTER key The SYSLOG data will be displayed in CHAR format A LOG User s Manual 10 61 Chapter 10 A LOG Terminal Operations Request for Printing of SYSLOG Data Prior to the request for printing of SYSLOG data a value must be specified for the SYSLOG ID PRINT JOB NAME PRINT CLASS PRINT DEST CODE items in 3 1 0 SYSLOG Data Select screen Required Item PRINT MAX LINES Specify maximum number of lines to be printed COMMAND Specify PRINT command Specify the above and press ENTER key WTRSUTL utility will be submitted and the corresponding SYSLOG data will be printed Note Printing of SYSLOG is not performed during dumping of SYSLOG data Screen Messages FIND STRING NOT FOUND Unable to find the character string specified in F command in the SYSLOG data INVALID COMMAND An invalid command has been specified SYSLOG DATA NOT FOUND SYSLOG data record does not exist PRINT MAX LINES ERROR MUST NOT A non zero non blank maximum print line number must be BE ZERO OR BLANK specified PRINT MAX LINES ERROR MUST BE A zero or blank maximum print line number must be specified ZERO OR BLA
67. not print SYSLOG Start separator UNIT gt Dump MT unit name Specify the unit name of the Dump MT This parameter is necessary only if the E SYSLOG to be printed is on a Dump MT and the unit name to be allocated to the Dump MT is not TAPE TIMEC gt Time Field Start Position Specify the start position of the Time field in SYSLOG data default is 26 TCOM gt Time Field Separator Specify the character used to separate the Time field in SYSLOG data default JNOC gt Job Number Field Start Position Specify the start position of the Job Number field in SYSLOG data default 38 JNOL gt Job Number Field Length Specify the length of the Job Number field in SYSLOG data default 8 4 Dump MT Information Specification The Dump MT information must be specified in DDIN DD statement if the following conditions are true e The SYSLOG data to be printed is on Dump MT e The UNIT keyword is not specified in the DDSPARM parameter and e The unit name for the Dump MT is not TAPE 11 82 A LOG User s Manual Chapter 11 A LOG System Utilities 11 20 4 Sample Execution JCLs WTRSUTL STEPLIB STEPCAT SYSOUT USMSOUT DBSNAP EXEC PGM WTRSUTL PARM S 0000 REGION 512K DD DSN ALOG V36 LOAD DISP SHR D DSN ALOG UCAT DISP SHR D SYSOUT D SYSOUT D D D D DD DUMMY SYSUDUMP DD SYSOUT DDSNAP DDKANJI YSUT1 SORTOUT SORTWKO1 DD UNIT SYSDA SPACE TRK SORTWKO2 D
68. 0000 GGGGGGGGGGGG 000000000000 GGGGGGGGGGGG 000 000 GGG GG 000 000 GGG 000 000 GGG 000 000 GGG GGGGG 000 000 GGG GGG 000000000000 GGGGGGGGGGGG GGGGG 00000000000 GGGGGGGGGGG USER ID GROUP ID A SPOOL A LOG Select Screen A SPOOL A LOG SELECT COMMAND gt MENU NO A SPOOL A LOG USER ID GROUP ID 10 8 A LOG User s Manual BSP INC 96 08 04 14 33 44 XEXIT TO TERMINATE Chapter 10 A LOG Terminal Operations 0 0 0 Initial Menu Screen A LOG 0 0 0 INITIAL MENU 96 09 04 14 03 35 SELECT gt LOGON ID G34A MASTER MANAGEMENT 1 JOB SYSLOG MASTER MAINTENANCE JOBLOG MANAGEMENT 1 JOBLOG INDEX MAINTENANCE 2 DUMP MT INQUIRY SYSLOG MANAGEMENT 1 SYSLOG DATA INQUIRY 2 SYSLOG INDEX MAINTENANCE SYSTEM MANAGEMENT 1 TERMINAL PF KEYS SETTING END This screen shows the menu numbers and key functions of A LOG Terminal Facility To switch to a specific screen enter the menu number for the SELECT item and press the ENTER key To terminate the A LOG Terminal Facility enter X for the SELECT item and press the ENTER key During interaction A LOG Terminal Facility may display the following messages on this screen INVALID MENU NO An invalid menu number has been specified n n n CALLED SCREEN LOAD ERROR An error has occurred while loading a screen module for menu numbered n n n Ending a Session To terminate A LOG Terminal Faci
69. 003 RETENTION DAYS 0003 DUMP DELETE CATLG START DATE 961016 CATLG END DATE 961016 START TIME STATUS CATLG DESTINATION CODE SYSLOG COMMENT gt USER COMMENT gt 000269 LINE COUNT 00032385 5 DATASET COUNT 001 tou ou il 090354 END TIME 104047 END STATUS PLACE DUMP MT tou ou a Fig 4 2 SYSLOG Index Screen 4 2 A LOG User s Manual Chapter 4 A LOG SYSLOG Storage Facility A LOG 3 2 2 2 SYSLOG INDEX NO 1 INQ UPD 96 11 04 14 21 19 COMMAND gt JOB NAME SYSLOG LOG DATE 961015 JOB NO STC00001 SYSLOG ID SYSLOG DUMP DSNAME ALOG V0380 LDMP VOL SER ALOGO1 LABEL 0002 RESTORE REQUEST ON RESTORE STATUS RESTORE DATE RESTORED DATA RESTORED INDEX RETENTION DAYS gt 0000 RETENTION DAYS gt 0000 Fig 4 3 SYSLOG Index Screen osname resort OOO O LOGDATE A LOG operation date when the SYSLOG is stored JoBno tobmmberoflleSYSLOG SYSLOG ID of the SYSLOG Master record to be referenced when NN a SYSLOG index is created for the SYSLOG L1OBSTARTDATE Umued blant JOBENDDATE Unused blank STARTTIME Unued bianky FENDTIME Unused blank PAGECOUNT Total numberof pages ofthe SYSLOG LINECOUNT_ Toalmumberoflines ofthe SYSLOG O loa EES 734 SYSOUT CLASS SYSOUT class of the SYSLOG in OS Spool DATASET COUNT This value is always set as 001 JOB CLASS Job class of the SYSLOG Master record RETENTION DAYS Dump Retention Period of the SYSLOG Ma
70. 2 10 17 45 13 ZZKCS5Q JOB02590 96 02 10 4 96 02 10 BSP216 L100202 COPY JBI COUNT 0005 Dataset Name of Dump MT Y Storage Status Label Number of Dump MT A Not Yet Stored Job Log Storage Date END Storage Ended Job Log Storage Time ABEND Storage Abended Job Name Number of Dumped Pages Job Number Volume Serial Number of Dump MT lt gt Job Start Date Job Log ID x Job Start Time 2 Job Completion Code Date when Delete Retention Period is Expired A LOG User s Manual 11 41 Chapter 11 A LOG System Utilities 11 13 ALOGJMST Utility 11 13 1 Functional Overview ALOGJMST utility is used to perform batch maintenance and inquiry of Job Log and SYSLOG Master files The maintenance functions provided are registration deletion and update of Job Log SYSLOG Master information The result of maintenance functions are output to the Master File Maintenance Proof List For inquiry function the selected Job Log SYSLOG Master information are output to the Master File Inquiry List All of these functions are specified using Master definition cards ALOGJMST utility terminates with the following return codes to indicate the output of its processing O Normal termination 4 File open error 8 EXEC parameter specification error 12 Sort error 16 Internal errors 11 13 2 Processing Requirement 11 42 EXEC Parameter Master Definition Cards ALOGJMST Job Log Mas
71. 960814 003341 960815 003341 KKKKKKKKKX Fig 7 23 SYSLOG Directory Screen REST ON command can also be entered from 3 2 2 1 SYSLOG Index or 3 2 2 2 SYSLOG Index screen In this case it reserves only the SYSLOG currently displayed on the screen for restoration A LOG User s Manual A LOG 3 2 2 2 COMMAND gt JOB NAME JOB NO DUMP DSNAME VOL SER LABEL RESTORE REQUEST RESTORE DATE RESTORED DATA RETENTION DAYS Chapter 7 A LOG Retention Management Facility SYSLOG INDEX NO 1 INQ UPD 96 09 04 14 21 19 SYSLOG STC00001 Al Al 0 gt 0 LOG V0380 LDMP LOGO1 002 001 LOG DATE 960815 SYSLOG ID SYSLOG RESTORE STATUS RESTORED INDEX RETENTION DAYS gt 0013 Fig 7 24 SYSLOG Index Screen 2 Execute ALOGRSEL utility A LOG User s Manual Chapter 7 A LOG Retention Management Facility 7 7 Deletion of Job Logs or SYSLOGs 7 7 1 Introduction Job logs or SYSLOGs can be deleted from A LOG Management Database and A LOG Data Pool using any one of the following three 3 methods e Deletion from A LOG Terminal Facility e Deletion by ALOGDLTS Utility e Deletion by ALOGDLT1 Utility 7 7 2 Deletion from A LOG Terminal Facility Job log indexes and or data can be deleted from A LOG Management Database and A LOG Data Pool using 2 1 1 1 2 Job Log Directory screen SYSLOG indexes and or data can be deleted from A LOG Management Data
72. A LOG User s Manual Version 3 8 Manual Order Number ALG 380 020 1 This manual is applicable to A LOG product at Version 3 8 release level Unless otherwise stated in new editions of this manual or A LOG technical release notes or document this manual is also applicable to all subsequent releases of the A LOG product Product information specified in this manual is subject to change without notice Data used in examples are fictitious information unless otherwise specified No part of this manual may be reproduced or transmitted in any form or by any means electronic or mechanical for any purpose without the written permission of BSP Inc Copyright C 1996 by BSP Inc Tokyo Japan All rights reserved A CONSOLE A GATHER A GATHER FS for UNIX A AUTO A AUTO REMOTE A AUTO for UNIX A AUTO for OS 400 A VOLMANAGER A RECOVERY A LOG A SPOOL A SPOOL FS for UNIX A SPOOL MAIL A SPOOL ONLINE CICS A SPOOL RVIEW A NAVIGATOR A QUALITY and A SUPERVISION are trademarks of BSP Inc All other trademarks are property of their respective companies Table of Contents Preface Chapter 1 A LOG System Facilities 1 1 Components of A LOG System 000 ee eeeeeseeeneeeneecneeenaeeneeeecueeeeeaees 1 1 1 2 A LOG System Facilities unninn neiii eee 1 2 1 3 Support for Multiple CPUS eee ie eiin a aai aieia 1 6 Chapter 2 A LOG Master Management Facility 2 1 Master Management Functions ooococccoccconaconoconoconnconnnnnn non
73. A0032 JA0033 JA0034 JL AJOBO001 lt AJOB999 INPUT CARD COUNT 0016 ERROR CARD COUNT 0005 LIST CARD COUNT 0001 OUTPUT RECORD COUNT 0002 ADD 0002 DELETE 0000 Content of Master Definition Card Number of Error Cards Ak Error Code Number of Master List Control Cards ak Number of Input Cards Number of Output Master Records Total Registration Deletion A LOG User s Manual 11 47 Chapter 11 A LOG System Utilities Master Maintenance Proof List A LOG ADVANCED JOBLOG SYSLOG MANAGEMENT SYSTEM VERSION 03 80 BY BSP INC DATE 96 06 05 TIME 18 57 09 MASTER FILE MAINTENANCE CHECK LIS LIST CODE JAMO02 k He 8 JOBLOG ID LID DATE SEQ NO RESULT ERROR MESSAGE AJOBO0002 960601 JOBLOGO1 960601 INPUT FILE COUNT DELETE FILE COUNT ADD FILE COUNT ERROR FILE COUNT Job Log SYSLOG ID Valid Date Sequence No Processing Result Error Message Area Number of Input Master Records lt gt Number of Deleted Records x Number of Registered Records lt Number of Error Records A LOG User s Manual 11 48 Chapter 11 A LOG System Utilities Master File Inquiry List A LOG ADVANCED JOBLOG SYSLOG MANAGEMENT SYSTEM VERSION 03 80 BY BSP INC DATE 96 06 05 TIME 19 09 20 MASTER FILE INQUIRY LIST JAM LIST CODE JAMOO1 JOBLOG ID gt AJOBO002 VALID DATE gt 960601 SYSOUT CLASS gt 2 JOB CALSS gt 2 RETENTION DAYS gt 0007 RETENTION DAYS
74. ACE RSTR DATE TIME DATE TIME 001 SYSLOG 960107 960901 125520 960901 125520 BKS 002 SYSLOG 960815 960815 134559 960815 134559 DUMP MI 003 SYSLOG 960815 960816 090354 960816 090354 DUMP MI 004 SYSLOG 960816 960816 104636 960816 104636 BKS 005 SYSLOG 960819 960820 005401 960820 005401 BKS 006 SYSLOG 960819 960820 024144 960820 024144 BKS 007 SYSLOG 960828 960830 003341 960830 003341 BKS 008 SYSLOG 000101 300101 011742 300101 011742 BKS 009 SYSLOG 000229 000229 013359 000229 013359 BKS KKKKKKKKKK END OF DATA kkkkkkkkkxk Function This screen displays the list of SYSLOG indexes satisfying the selection criteria as specified in 3 2 0 SYSLOG Index Maintenance screen The list is sorted in the order of SYSLOG Storage Date It is used for the following operations e Reference Modify attributes of SYSLOG indexes e Deletion of SYSLOG index and data e Request restoration of SYSLOGs e Reserve restoration of SYSLOGs e Cancel reservation for restoration of SYSLOGs e Search for specific SYSLOG ID Screen Commands MENU To switch to 0 0 0 Initial Menu screen XEXIT To terminate A LOG Terminal Facility EXIT To switch to 3 2 0 SYSLOG Index Maintenance screen To scroll up one page of SYSLOG index DOWN To scroll down one page of SYSLOG index A LOG User s Manual Chapter 10 A LOG Terminal Operations To display first page of SYSLOG index BOTTOM
75. ALOG D930603 NX MT LABEL 001 gt H o o Y CAT DATE CAT TIME JOB NO S DATE COND P DATE ST M PAGE VOLSER 96 06 01 09 12 35 LST JOB00309 96 06 01 000000 96 06 03 END 293 C960813 96 06 01 09 15 59 LST JOB00313 96 06 01 000000 96 06 03 END 342 C960813 96 06 01 10 35 35 LSI JOB00520 96 06 01 000000 96 06 03 END 84 C960813 96 06 01 10 49 13 LST JOB00584 96 06 01 000000 96 06 03 END C960813 96 06 01 11 25 47 LST JOB00691 96 06 01 000000 96 06 03 END C960813 COPY JBI COUNT 0005 RERER Dataset Name of Dump Copy MT Label Number of Dump Copy MT Storage Date of Copied Job Log SYSLOG Storage Start Time of Copied Job Log SY SLOG Job Name of Copied Job Log SYSLOG Job Number of Copied Job Log SYSLOG Job Start Date of Copied Job Log SY SLOG x Job Completion Code of Copied Job Log SY SLOG lt gt Date when Copied Job Log SYSLOG was Deleted from A LOG Database Storage Status of Copied Job Log SYSLOG Number of Pages of Copied Job Log SYSLOG Volume Serial Number of Dump Copy MT A LOG User s Manual 11 19 Chapter 11 A LOG System Utilities 11 10 High Speed Dump amp Delete Utilities 11 20 The High Speed Dump amp Delete utilities consists of 4 utilities ALOGDMP1 ALOGDMP2 ALOGDMP3 and ALOGDMP4 Together these utilities provide the following functions e Dump job log data that have exceeded the Dump Retention Period e Delete restored jog log data that have exceeded the retention peri
76. ALOGDATE utility is used to set the Operation Date for A LOG The date to be set is specified in the EXEC parameter The current CPU date is used when no date is specified The Operation Date is stored in A LOG System File 11 5 2 Processing Requirement EXEC Parameter A LOG Management Database a Eo ALOGDATE _ gt System File Utility Fig 11 4 Processing Outline of ALOGDATE Utility To execute ALOGDATE utility specify the Operation Date in EXEC parameter as required Then run the utility 11 5 3 Input Requirement The EXEC parameter for ALOGDATE utility ALOGDATE PDATE yymmdd where PDATE gt Operation Date If no date is specified the current CPU date is used 11 5 4 Output Messages The following messages are output on the console when ALOGDATE utility is executed SPM2021 CURRENT DATE SET TO 97 04 23 SPM2001 START UP DATE PROCESSOR SPM2011 FINISH DATE PROCESSOR SPM3051 WRITER LOGY WAS CLOSED SPM3041 WRITER LOGX WAS SELECTED A LOG User s Manual 11 7 Chapter 11 A LOG System Utilities 11 6 ALOGDETI Utility 11 6 1 Functional Overview ALOGDLT1 utility is used to delete the data of job logs and SYSLOGs that have been dumped to Dump MT However if the data is one that has been restored from Dump MT it is deleted only if the following condition is met Last Restore Date After Restore Data Retention Period lt A LOG Operation Date 11 6 2 Processing Requirement EXEC Parameter A ALO
77. Cards A Job Log Message definition card is a parameter for specifying the search criteria for collecting the following information from a job log messages e Job start date and time e Job end date and time e Abend code of a job and the highest completion code e JCL Error A LOG User s Manual Chapter 3 A LOG Job Log Storage Facility The collected information is registered in the job log index A user can use these information to manage job logs The user can also create a job log exit routine for checking other information other than those mentioned above Format amp Item Name Col Length Description Card Information Alphabetic Specify L ID 1 Y List Indicator 2 Alphabetic Specify one of the following indicators 1 J Job Log List L lt XIJCL list S lt amp lSystem Message List O lt amp ISYSOUT list Keyword 3 Alphabetic Specify a keyword Refer to Keywords of Job Log 8 Message Definition Card for further details 3 Message ID 11 Numeric Specify the starting column position of the Message ID as Column 3 specified in item Message ID 14 Numeric Specify the length of the Message ID as specified in item Length 3 Message ID Text Alphanumeric Specify Message ID 8 lt gt Word Column 25 Numeric Specify starting column position of the search criteria as 3 specified in item 9 Word Length 28 Numeric Specify the length of the search criteria as specified in item 3
78. D UNIT SYSDA SPACE TRK SORTWKO3 DD UNIT SYSDA SPACE TRK DDPARM DDCNTL DD DUMMY DYNALLOC MESSAGE DD DUMMY DD UNIT SYSDA SPACE TRK 1 1 DD DSN ALOG DMP D940210 DISP SHR UNIT TAPE DEFER VOL SER BSP001 D DSN ALOG V36 SCT DISP SHR D DSN ALO V36 BKS DISP SHR D SYSOUT DCB LRECL 133 BLKSIZE 1330 RECFM FBA DSN SYS1 SORTLIB DISP SHR UNIT SYSDA SPACE TRK 10 5 DD UNIT SYSDA SPACE TRK 1 1 1 1 R DD DSN ASPOOL V36 PARMLIB A DD DDSPARM DISP SHR PRINT SYS SYSLOG SELECT SSTR1 J0B00803 11 20 5 Output Listing A sample SYSLOG Start Separator is shown on the following page A LOG User s Manual 11 83 SYSLOG Start Separator SSSSSSS SS Ss SSS SSS Ss Ss S SSS SSS S SS SS SSS SSS SS S SSSSSSSS WWW WW WW WW WW WW WW WW WW WW WW WW W WW WW WWW WW WWWW WWWW WWW WWW YYYY Y Y Y TITTT a a YYYY Y Y Y PT PT PT PT PT PT pr nr nr pr rTTTTT a E SSSSSSS SS Ss SSS SSS Ss Ss S SSS SSS S SS SS SSS SSS SS S SSSSSSSS RRRRRRRR R R R RRRRRR R RR R RR SYSLOG NAME SYSLOG A LOG User s Manual 0000000 000 O 000 000 000 000 000 000 000 O sLLLLLLGL 0000000 SSSSSSS SS Ss SSS Ss S SSS SS SSS SSS S SS SS SSS SSS SS S SSS
79. Data Retention Period This defines the number of days for keeping a job log or SYSLOG data in A LOG Data Pool without deleting it after it has been restored into the A LOG Data Pool For those job log or SYSLOG data that have passed this retention period they can be deleted from A LOG Data Pool by executing ALOGDLT1 utility Fig 7 3 on the following page provides examples of the above types of retention periods A LOG User s Manual 7 3 Chapter 7 A LOG Retention Management Facility Dump Retention E Job Log SYSLOG that have not been restored Period 2 Days Job Log SYSLOG Storage Date Delete Retention Period 5 Days After Restore Data Retention E Job Log SYSLOG that have been restored Period 1 Day Delete Last Restore Date Target After Restore Index Retention Period 4 Days Fig 7 3 Status of Job Log SYSLOG and Retention Period 7 2 2 Correlation Between Retention Periods And Utilities The following utilities reference the retention periods which have been defined for job logs and or S YSLOGs ALOGJDMP utility ALOGLDMP utility ALOGDLT1 utility ALOGDLTS utility ALOGDMP1 utility ALOGDMP2 utility ALOGDMP3 utility Dump job logs indexes and data and delete job log data Dump SYSLOGs indexes and data and delete SYSLOG data Delete job log or SYSLOG data Delete job log or SYSLOG indexes and data Create a file for used by ALOGDMP1 and ALOGDMP2 utilities Dump job logs indexes
80. EEPI Numeric Specify the number of days between 0 1830 to retain the SYSLOG 1 4 index after restoration refer to Section 7 2 4 for default LIST Alphabetic Specify YES to list the contents of Dump MT in the Dump MT 3 Inquiry List 1 The job name Storage Date and Storage Time of a SYSLOG can be obtained from the SYSLOG Index Directory screen A LOG screen 3 2 1 the SYSLOG Dump Proof List or the Dump MT Inquiry List 2 The LIST keyword is mutually exclusive with all other keywords In other words in one execution of ALOGLRST utility either restore or list but not both function can be requested A LOG User s Manual 11 65 Chapter 11 A LOG System Utilities Example To restore SYSLOGs SYS001 SYS002and SYS003 RESTORE SID SYS001 MAKED 970115 MAKET 094538 INDEX NO KEEPD 1 KEEPI 3 RESTORE SID SYS002 MAKED 970116 MAKET 101855 INDEX NO KEEPD 1 KEEPI 3 RESTORE SID SYS003 MAKED 970117 MAKET 103415 INDEX NO KEEPD 1 KEEPI 3 Example To list the contents of a Dump MT volume RESTORE LIST YES 2 USMSLRST Parameter Card Specify the USMSLRST parameter card in USMSCARD DD statement The format of this card is as follows USMS UNIT unit name where UNIT gt Unit Device Name of the Dump MT Specify the device name of the Dump MT that contains the SYSLOG s to be restored E This is required only if INDEX NO or no INDEX keyword is specified in the restore parameter card and the Dump MT is to be
81. FILE FIND ERRPOR RSP xxx An error has occurred while finding Dump MT information record DMM FILE READ ERRPOR RSP xxx An error has occurred while reading Dump MT information record DMM STORE EXCEED MAX COUNT OF Number of Dump MT information records has exceeded the nnn maximum number allowed INVALID MENU NO An invalid menu number has been specified CALLED SCREEN NOT FOUND The function associated with the specified menu number is not available n n n CALLED SCREEN LOAD ERROR An error has occurred while finding screen module with menu number n n n A LOG User s Manual 10 51 Chapter 10 A LOG Terminal Operations 10 7 10 52 SYSLOG Management Terminal Operations 3 0 0 SYSLOG Management Screen A LOG 3 0 0 SYSLOG MANAGEMENT 96 09 04 14 16 49 COMMAND gt SEL SYSLOG DATA INQUIRY SYSLOG INDEX MAINTENANCE Function This screen is displayed when 3 is specified in SELECT item of 0 0 0 Initial Menu screen It is the first of a series of screens for performing deletion modification and inquiry of SYSLOG data and indexes Screen Operations From this screen you can proceed to 3 1 0 SYSLOG Data Select or 3 2 0 SYSLOG Index Maintenance screen as follows Required Item Specification SELECT NUMBER Specify 1 for SYSLOG data inquiry or 2 for SYSLOG index maintenance Specify the above and press ENTER key If 3 1 0 SYSLOG Data Select or 3 2 0 SYSLOG Ind
82. G STC00487 960831 161742 162118 0003 960107 V380ALOG STC00495 960831 162130 163529 0004 960812 V380ALOG STC00731 960812 132948 133659 0003 960812 V380ALOG STC00758 960812 133754 184431 0004 960812 V380ALOG STCO1482 960812 185724 190231 0003 960813 V380ALOG STC00247 960813 100341 122621 0003 960813 V380ALOG STCO1326 960813 171248 200230 0003 960819 V380ALOG STCO1607 960819 214535 220110 0004 960819 V380ALOG STCO1737 960819 235353 010055 0004 960831 V380ALOG STC00229 960831 142841 143019 KEKKKKKKERK END OF DATA x x Xx xXxXx xx NARRA SELECT B BROWSE P RESTORE REST ON REST OFF 2 1 1 2 Job Log Directory Screen A LOG 2 1 1 2 JOBLOG DIRECTORY INQ UPD 96 09 04 14 14 29 COMMAND gt OP MSG DATE JOB NAME JOB NO S DATE S TIME E TIME PLACE RSTR JOBLOG ID 960105 V380ALOG STC00345 960831 152605 152652 BKS JOBLOG 960105 V380ALOG STC00352 960831 152724 154415 BKS JOBLOG 960107 V380ALOG STC00420 960831 155034 161129 BKS JOBLOG 960107 V380ALOG STC00487 960831 161742 162118 BKS JOBLOG 960107 V380ALOG STC00495 960831 162130 163529 BKS JOBLOG 960812 V380ALOG STC00731 960812 132948 133659 DUMP JOBLOG 960812 V380ALOG STC00758 960812 133754 184431 DUMP JOBLOG 960812 V380ALOG STCO1482 960812 185724 190231 DUMP JOBLOG 960813 V380ALOG STC00247 960813 100341 122621 DUMP 960813 V380ALOG STCO1326 960813 171248 200230 DUMP JOBLOG 960819 V380ALOG STCO1607 960819 214535 220110 BKS J 960819 V380ALOG STCO1737 960819 235353 010055 BK
83. G is stored into A LOG database After storage of the job log or SYSLOG the Dump Retention Period for the job log or SYSLOG index can be modified Delete Retention Period This retention period is also specified in Job Log or SYSLOG Master The specified value is also kept in job log or SYSLOG index when the job log or SYSLOG is stored into A LOG database After storage of the job log or SYSLOG the Delete Retention Period for the job log or SYSLOG index can be modified A LOG User s Manual 7 5 Chapter 7 A LOG Retention Management Facility After Restore Index Retention Period and After Restore Data Retention Period These retention periods are specified when the job log or SYSLOG is restored from Dump MT The specified value is recorded in an index It is displayed on the bottom of 2 1 2 2 Job Log Index screen or 3 2 2 2 SYSLOG Index screen of A LOG Terminal Facility These values can be changed directly using anyone of these screens There are three methods of restoring job log or SYSLOG The specification method of the retention periods for each case is shown as follows e When executing ALOGJRST or ALOGLRST utility Specify the retention periods in a restore parameter e When executing ALOGRSEL utility after a restore request from A LOG Terminal Facility Specify the retention periods in RSELPARM parameter e When restoring joblog or SYSLOG using A LOG Terminal Facility Specify the retention periods in 2 1 0 Job Log Index
84. GDLT1 i Utility A LOG Management Database SYSPRINT Job Log SYSLOG Data Deletion Job Log Index SYSLOG Index Job Log Data SYSLOG Data A LOG Data Pool Proof List Fig 11 5 Processing Outline of ALOGDLT1 Utility To execute ALOGDLT1 utility specify the option to delete Job log data or SYSLOG data in the EXEC parameter Then run the utility 11 6 3 Input Requirement The EXEC parameter for ALOGDLT1 utility ALOGDLT1 D JOB SYS where JOB gt Delete dumped Job log data Default SYS Delete dumped SYSLOG data 11 6 4 Output Listing A sample output listing of Job Log SYSLOG Data Deletion Proof List is shown on next page 11 8 A LOG User s Manual Chapter 11 A LOG System Utilities Job Log SYSLOG Data Deletion Proof List A LOG ADVANCED JOBLOG SYSLOG MANAGEMENT SYSTEM VERSION 03 80 BY BSP INC DATE 96 02 14 TIME 08 43 3 PROOF LIST OF DLETE BKS WITH DUMPED JOBLOG LIST CODE DLTO1 J EE 9 amp O CAT DATE CAT TIME JOB NAME JOB NO S DATE COND ST W PAGE RET MSG RST DATE 96 02 07 15 32 53 ALGJOBO1 JOB00392 96 02 07 000000 DUMP 251 000000 DUMPED 96 02 07 15 48 22 LGJOBO2 JOB00403 96 02 07 000000 DUMP 3905 000000 DUMPED 96 02 07 16 03 33 LGJOB03 JOB00420 96 02 07 e 000000 DUMP 18 000000 DUMPED 96 02 07 16 03 55 LGJOB04 JOB00421 96 02 07 000000 DUMP 3 000000 DUMPED 96 02 07 16 18 21 LGJOBO5 JOB00435 96 02 07 000000 DUMP 83 000000 DUMPED
85. IME 10 21 53 PROOF LIST OF RESTORE JOBLOG LIST CODE RST100 J DSN JOBLOG D891026 lt gt CAT DATE CAT TIME JOB NAME S DATE S TIME VOLSER 96 02 05 04 05 01 ASPI JOB03742 96 02 05 03 14 19 BSP216 96 02 05 08 16 51 ASPI JOB00185 96 02 05 08 15 54 BSP216 Dataset Name of Dump MT amp Storage Status Job Log Storage Date A Not Yet Stored Job Log Storage Time END Storage Ended Job Name ABEND Storage Abended Job Number yx Label Number of Dump MT Job Start Date Volume Serial Number of Dump MT lt gt Job Start Time Job Log ID x Job Completion Code Number of Pages A LOG User s Manual 11 53 Chapter 11 A LOG System Utilities Dump MT Inquiry List A LOG ADVANCED JOBLOG SYSLOG MANAGEMENT SYSTEM VERSION 03 80 BY BSP INC DATE 96 02 14 TIME 22 27 11 DUMP TAPE INDEX LIST BY JOBLOG DSNAME JOBLOG D921026 LABEL 001 5 o o gt o CAT DATE CAT TIME JOB NAME J S TIME S BLOCKS E BLOCKS VOLUME 96 02 01 ZZKCS4T JOB02182 96 02 01 H A 01 00284 01 00286 BSP216 96 02 01 ZZKCS4T JOB02441 96 02 01 01 00287 01 00289 BSP216 96 02 01 i ZZKCS4T JOB02544 96 02 01 E 01 00290 01 00292 BSP216 96 02 01 ZZKCS5B JOB02654 96 02 01 01700293 01 00297 BSP216 96 02 01 3 ZZKCS5Q JOB02590 96 02 01 E 01 00298 01 00302 BSP216 Dataset Name of Dump MT v Storage Status Label Number of Dump MT A Not Yet Stored Sequence N
86. INES Specify the maximum number of lines that can be printed for one submission of ERRANTE a PRINT PRINT DEST CODE CODE Specify the destination code of SYSLOG ssid the destination code of SYSLOG Specify the above and any additional search criteria for the selection of SYSLOG records to be printed such as JOB NUMBER SCH DATE SYSLOG TIME and or DISPLAY LINES items then press the ENTER key WTRSUTL utility will be submitted and the corresponding SYSLOG data will be printed For dumped SYSLOG data a tape mount request for the Dump MT will be issued automatically Screen Messages CALLED SCREEN NOT FOUND The function associated with the specified menu number is not available SYSLOG DATA NOT FOUND No SYSLOG record satisfies the specified search criteria DISPLAY LINES EXCEEDED TABLE MAX The number of SYSLOG records has exceeded the nnnnn RECORD maximum display line number SYSLOG DATA ACCESS ERROR RC An error has occurred when accessing SYSLOG record aaaa bbbb aaaa is the response code of ASPSACS bbbb is the detailed code of ASPSACS Specified job number does not start with a J S or T A LOG User s Manual 10 57 Chapter 10 A LOG Terminal Operations JOB NUMBER ERROR MUST NOT BE Specified job number is filled with zeroes ZERO DATE ERROR MUST BE NUMERIC A non numeric date has been specified DATE RANGE ERROR Specified date is not in yymmdd format DATE ERROR FROM gt TO FROM
87. If only the ending page is specified the search is performed from the current page until the specified ending page If the search is performed on data displayed in HEX format specify the character string in HEX format such as FIFOS5BC140C2 A LOG User s Manual Chapter 10 A LOG Terminal Operations To continue searching for the same character string specify FIND command and press ENTER key Display of Job Log Data in HEX Format Required Item Specification COMMAND Specify HEX command Specify the above and press ENTER key The job log data will be displayed in HEX format Display of Job Log Data in CHAR Format By default job log data will be displayed in CHAR format unless HEX command has been entered as described in To revert back to display in CHAR format do the following Required Item Specification COMMAND Specify CHAR command Specify the above and press ENTER key The job log data will be displayed in CHAR format Screen Messages REPORT DATA NOT FOUND Job log data specified in job log index does not exist in A LOG database REPORT PAGE EXCEEDED TABLE Page size of job log data has exceeded the internal area size FIND STRING NOT FOUND Unable to find the character string specified in F command in the job log data DATA CODE NOT FOUND SYSOUT dataset with specified data code does not exist in the job log SYSOUT SEQ NO NOT FOUND SYSOUT dataset with specified sequence number does not exi
88. Immediate Print The job log is printed immediately by a user exit routine during storage of the job log into A LOG database e Print from A LOG Terminal Facility The job log is printed by an instruction from a TSO or TSS terminal using A LOG Terminal Facility e Execution of WTRJUTL utility The job log is printed by executing WTRJUTL utility Refer to Chapter 5 A LOG Job Log Print Facility for further details A LOG SYSLOG Print Facility This facility is used to print SYSLOGs which have been stored in A LOG database Two methods of printing a SYSLOG are provided e Print from A LOG Terminal Facility The SYSLOG is printed by an instruction from a TSO or TSS terminal using A LOG Terminal Facility e Execution of WTRSUTL utility The SYSLOG is printed by executing WTRSUTL utility Refer to Chapter 6 A LOG SYSLOG Print Facility for further details A LOG Retention Management Facility This facility manages the retention of job logs and SYSLOGs in A LOG database The retention of job logs and SYSLOGs is based on the following approaches e Dump Retention Period This specifies the number of days the job logs or SYSLOGs are to be retained in A LOG database After this period has expired ALOGJDMP or ALOGLDMP utility shall dump the expired job logs or SYSLOG into a magnetic tape In this case indexes are retained 1 4 A LOG User s Manual Chapter 1 A LOG System Facilities e Deletion Retention Period Thi
89. Index Maintenance or 2 2 0 Dump MT Inquiry screen as follows Required Item Specification SELECT NUMBER Specify 1 to proceed to 2 1 0 Job Log Index Maintenance screen or 2 to proceed to 2 2 0 Dump MT Inquiry screen If 2 1 0 Job Log Index Maintenance or 2 2 0 Dump MT Inquiry screen is protected and you do not have the authority to access to that screen control is returned to this screen after pressing the ENTER key A LOG User s Manual 10 23 Chapter 10 A LOG Terminal Operations Flow of Job Log Management Screens The following figure shows the flow of job log management screens Initial Menu Legend xxxx Command 2 0 0 Job Log Management 2 1 0 2 2 0 Job Log Index Dump MT MENU Maintenance Inquiry 2 1 1 1 2 Job Log Directory 2 1 3 Job Log Index No 2 2 1 4 Job Log Inquiry Fig 10 5 Screen Flow of Job Log Management Function 10 24 A LOG User s Manual Chapter 10 A LOG Terminal Operations 2 1 0 Job Log Index Maintenance Screen A LOG 2 1 0 JOBLOG INDEX MAINTENANCE 96 09 04 14 09 05 COMMAND gt SELECT FUNCTION gt FUNCTION SELECT KEYS D DELETE BLANK INQUIRY UPDAT LOG DATE JOB NAME JOBLOG ID JOB CLASS COND CODE Lia EQUAL START DATE GREATER OR EQUAL START TIME LESS OR EQUAL FROM gt NOT EQUAL TO gt WRITER NAME gt WRITER SUBMISSION BY JOB gt 960905 SELECT KEY OF COND CODE
90. JOBCAT F2371 8El ALLOCATED TO INP F2371 8El ALLOCATED TO OUO F2371 JES2 ALLOCATED TO SYSPRINT F2371 JES2 ALLOCATED TO SYSIN F1421 D53YCOPY IEBCOPY STEP WAS EXECUTED COND CODE 0000 F2851 ADACAT KEPT F285I VOL SER NOS ADA200 F285I SDB2 D53Y LOAD KEPT System Message F285I VOL SER NOS ADA210 DVENSYES2 F2851 SDB2 ADACSH LOAD KEPT JOBO0614 V J F285 L SER NOS ADA210 P0000004 F285 ES2 JOB00614 00000102 SYSOUT F285I JES2 JOB00614 00000101 SYSIN F373I STEP IEBCOPY START 92171 F374I STEP IEBCOPY STOP 92171 OMIN 00 42SEC SRB OMIN 00 08SEC VIRT 512K SYS 172KEXT 4K SYS 9052K F375I JOB D53YVOPY START 92171 F3761 JOB D53YVOPY STOP 92171 OMIN 00 42SEC SRB OMIN 00 08SEC HHA RAR APPR eee eee A LOG User s Manual 3 14 Chapter 3 A LOG Job Log Storage Facility Job Log Message Sample continue ITEBCOPY MESSAGES AND CONTROL STATEMENTS COPY INDD INP OUTDD 0U0 S M ADANC6 ADANC9 IEF1671 FOLLOWING MEMBER S COPIED FROM INPUT DATA SET REFERENCED BY INP SYSOUT IEF167I ADANC6 HAS BEEN SUCCESSFULLY COPIED DSN JES2 J0B00614 P000001023 IEF167I ADANC9 HAS BEEN SUCCESSFULLY COPIED IEF167I THERE ARE 0000002 UNUSED TRACKS IN OUTPUT DATA SET REFERENCED BY OUO IEF167I THERE ARE 0000000 UNUSED DIRECTORY BLOCKS IN OUTPUT DIRECTORY IEF167I END OF JOB 00 WAS HIGHEST SEVERITY CODE Layout of Job Log Message Definition Card IBM MVS XA MVS ESA JES2 3 1 1 MVS E
91. LOG 18 30 00 STC 54 JEM395I ALOGSLOG ENDED 4 8 A LOG User s Manual Chapter 5 A LOG Job Log Print Facility OS Spool Immediate oo ALOGJLOG Utility Print J ob Log Job Log Resident Program Listing Management Data Pool Database ALOGJDMP Utility A LOG Terminal Facility WTRJUTL ns Utility e Print Instruction Job Log Listing Chapter 5 A LOG Job Log Print Facility 5 1 Introduction There are three methods of printing job logs managed by A LOG System e Immediate Print e Print by instruction from A LOG Terminal Facility e Print by executing WTRJUTL utility These are highlighted in the following diagram Immediate o gt ALOGJLOG Utility Print Job Log Resident Program Listing OS Spool Job Log A LOG Management Database ALOGJDMP Utility A LOG Terminal Facility TSO TSS LLN p WTRJUTL lt lt Utility e Print Instruction Job Log Listing Fig 5 1 A LOG Job Log Print Facility A LOG Data Pool A LOG User s Manual 5 1 Chapter 5 A LOG Job Log Print Facility 5 2 Immediate Print In this case specific job logs which are being stored into A LOG database can be selected and printed immediately by ALOGJLOG utility using a user exit routine For example job logs for jobs which have abended can be printed immediately There are two ways of implementing immediate print method These are
92. LOG Monitoring Facility 9 2 Operation Date An Operation Date is a date for the operations of A LOG System This date may differ from the CPU date of the computer Set an Operation Date for A LOG System after the normal initiation of A LOG Monitor There are following two 2 methods of setting of an Operation Date By entering A LOG Monitor DATE command refer DATE command in 9 4 A LOG Monitor Command for further details By executing ALOGDATE utility refer ALOGDATE Chapter 11 A LOG System Utilities for further details The Operation Date is an important date for managing the job logs or SYSLOGs and the A LOG database within A LOG system It is used in the following situations By comparing the Operation Date with the Valid Date of master records in A LOG database it decides whether the Job Log Master or SYSLOG Master record is valid The Operation Date is used for setting the Storage Date of the job logs or SYSLOGs when the job log or SYSLOG indexes are created at the time of storage of job logs or SYSLOGs The Operation Date is used as a default when a Delete Reference Date is omitted for job log or SYSLOG delete utility execution The Operation Date is used as a default when a Dump Reference Date is omitted for job log or SYSLOG dump utility execution H The Operation Date is used as a default when a Target Date is omitted for job log or SYSLOG audit trail utility execution A LOG User s Manual
93. LOG index for each SYSLOG by referring to a master record specified DDSCNTL parameter Storage of a SYSLOG without a SYSLOG Master Record Since there is no default in the SYSLOG master the SYSLOG ID must be specified in DDSCNTL parameter If not specified ALOGSLOG does not store the SYSLOG OS Spool SYSLOGs Operating System DDSCNTL Parameter DDSCNTL Specific EXEC Classes Parameter WRITELOG DDCATS DDCAT ALOGSLOG Command Parameter Utility SYSLOG SYSLOG SYSLOG Data Master Index A LOG Management Database A LOG Data Pool Fig 4 4 ALOGSLOG Utility Processing Outline 4 6 A LOG User s Manual Chapter 4 A LOG SYSLOG Storage Facility 4 4 2 Description of Specification Items EXEC Parameters ALOGSLOG CNTL DDSCNTL parameter member name DDCATS DDCATS parameter member name CNTL DDSCNTL parameter member name Specify member name of DDSCNTL parameter Default is DDSCNTL NX DDCATS DDCATS parameter member name Specify member name of DDCATS parameter Default is DDCATS DDSCNTL Parameter Specify keyword value pair from the first column of DDSCNTL parameter card If more than one keywords are specified separate them by commas Keywords may be specified in any order keyword value keyword valuel Format amp Keyword Length of Value Description Mandatory SYSLOG ID Alphanumeric Specify the SYSLOG ID of SYSLOG Master to be 1 8 referenced INTERVAL Numeric S
94. LOG to be printed MKTMF gt Start Time of SYSLOG to be printed MKTMT gt End Time of SYSLOG to be printed SELECT Statement Format SELECT JOB jobnamel PRMAX max print lines SSTR1 search string SSTR2 search string PRF start line no PRT end line no where JOB Job Name Specify this parameter to print the SYSLOG records of a specific job only PRMAX gt Maximum Print Lines Specify the maximum number of lines to print in 8 digits or less SSTR1 SSTR2 gt Search String s Specify one or more search strings Only SYSLOG records containing any of the specified strings will be printed When multiple strings are specified separate them with commas If a string contains blanks enclose the string within apostrophes E The maximum number of characters that can be specified in SSTR1 is 32 Specify characters in excess of 32 in SSTR2 Refer to the following page for examples A LOG User s Manual Chapter 11 A LOG System Utilities Examples e SSTRI ALOG 940201 To print SYSLOG records containing either ALOG or 940201 e SSTR1 F TSO USERMAX To print SYSLOG records containing F TSO USERMAX e SSTR1 DU PRT2 ALOG To print SYSLOG records containing either DU PRT2 or ALOG e SSTR1 F TSO USERMAX 940201 F ALOG 32 characters SSTR2 DATE To print SYSLOG records containing either F TSO USERMAX or 940201 or F ALOG DATE
95. M0111 OPERATOR TYPED IN DSPACE SPM107I ALOG 43 SPOOL UTILIZATION z ABSINDX ALLOCATE 006000K 008 UTILIZATION ABSDATA ALLOCATE 012000K 046 UTILIZATION ve Usage rate of A LOG Data Pool The number of Kbytes allocated and the usage rate of VSAM file index portion of A LOG Management Database The number of Kbytes allocated and the usage rate of VSAM file data portion of A LOG Management Database A LOG User s Manual 9 7 Chapter 9 A LOG Monitoring Facility 9 5 3 DT Command Function To display the current Operation Date and CPU time of A LOG System under operation Command Syntax F ALOG DT Example Operator enter F ALOG DT A LOG messages displayed on console SPMO11I OPERATOR TYPED IN DT SPM406I A LOG DATE DISPLAY 96 06 01 13 58 56 9 8 A LOG User s Manual Chapter 9 A LOG Monitoring Facility 9 5 4 DUSQ Command Function To display the information concerning the current users of A LOG System Command Syntax F ALOG DUSQ DU e DUSQ DU DUis the short form of DUSQ command Example Operator enter F ALOG DU A LOG messages displayed on console SPM011I OPERATOR TYPED IN DU SPM401I A L O G ACTIVE USER USLP ACTIVE USER LOGON ID ASPLO1 x ALOG ACTIVE USER S 001 Logon ID of current user of A LOG Terminal Facility Total number of current users in A LOG System A LOG User s Manual 9 9 Chapter 9 A LOG Monitoring Facilit
96. MP2 utility is as follows 1 Start A LOG Monitor 2 Specify the Dump MT volume serial number in EXEC parameter and 3 Run ALOGDMP2 utility A LOG User s Manual Chapter 11 A LOG System Utilities 11 10 2 3 Input Requirement 1 EXEC Parameter ALOGDMP2 VOL volser where VOL gt Dump MT Volume Serial Number Specify the volume serial number of the Dump MT To change the dataset name of E the Dump MT modify DDOUT DD statement of the JCL 11 10 2 4 Output Listings Refer to ALOGJDMP utility for an example of the Job Log Dump Proof List Refer to ALOGDLT1 utility for an example of the Job Log Data Deletion Proof List A LOG User s Manual 11 25 Chapter 11 A LOG System Utilities 11 10 3 ALOGDMP3 Utility 11 10 3 1 Functional Overview ALOGDMP3 utility 1s used to delete the index and data of expired job logs A processing date which is a criterion for determining whether a job log has expired can be specified in EXEC parameter If it is not specified the current A LOG Operation Date is used as the processing date A list of the deleted job logs is output to the Job Log Index Deletion Proof List The functions of this utility are the same as ALOGDLTS utility except that it cannot be used to delete SYSLOGs Please refer to ALOGDLTS utility for more information This utility requires the Job Log Index File All Job Logs and Job Log Data Index File created by ALOGDMP1 utility Therefore ALOGDMP1 utility must be executed
97. Maintenance screen or 3 2 0 SYSLOG Index Maintenance screen Refer to in Chapter 10 A LOG Terminal Facility and Chapter 11 A LOG System Utilities for further details A LOG User s Manual Chapter 7 A LOG Retention Management Facility 7 3 Calendar Date amp Working Date There are two methods for calculating the last day of the retention period of a job log or SYSLOG These are described as follows e Retention management based on Calendar Date The last day of the retention period is calculated simply by adding elapsed days e Retention management based on Working Date The last day of the retention period is calculated by adding elapsed days after subtracting holidays Retention management by Working Date is used by the following retention management utilities e ALOGJDMP utility Dump job logs indexes and data and delete job log data e ALOGLDMP utility Dump SYSLOGs indexes and data and delete SYSLOG data e ALOGDLT1 utility Delete job log or SYSLOG data e ALOGDLTS5 utility Delete of job log or SYSLOG indexes and data e ALOGDMP1 utility Create a file for used by ALOGDMP1 and ALOGDMP2 utilities e ALOGDMP2 utility Dump job logs indexes and data and delete job log data e ALOGDMP3 utility Delete job logs indexes and data Only when retention periods are less than or equal to 29 days the reference to Holiday Master is specified in EXEC parameter and retention management by Working Date is perform
98. Modification Inquiry or Source Copy D Deletion JOB SYSLOG ID MAD Job log or SYSLOG ID is displayed VALID DATE ae eee Valid date is displayed Screen Operations Selection of a Master Record for Copying If there are two or more master records selected for copying these master records are displayed on this screen Required Item Specification lop Specify S for the master record to be selected Specify the above and press ENTER key Contents of the master record to be copied will be displayed on 1 1 2 Job Log SYSLOG Master screen Selection of Master Records for Deletion Required Item lop Specify D for the master record to be selected for deletion COMMAND Specify DELETE command Specify the above and press ENTER key The selected master record will be deleted A LOG User s Manual Chapter 10 A LOG Terminal Operations Nk Selection of a Master Record for Viewing or Updating Required Item Specification lop Specify S for the master record to be selected for viewing or updating Specify the above and press ENTER key Contents of the master record will be displayed on 1 1 2 Job Log SYSLOG Master screen for viewing or updating Search for a Job Log or SYSLOG ID Required Item COMMAND Specify E job log syslog id Prefix may be specified Specify the above and press ENTER key The job log or SYSLOG ID found will be displayed on the first line of the screen
99. NK DISPLAY LINES ERROR MUST NOT A non zero non blank display line number must be specified BE ZERO OR BLANK DISPLAY LINES ERROR MUST BE A zero or blank display line number must be specified ZERO OR BLANK 10 62 A LOG User s Manual Chapter 10 A LOG Terminal Operations 3 2 0 SYSLOG Index Maintenance Screen A LOG 3 2 0 SYSLOG INDEX MAINTENANCE 96 09 04 14 18 35 COMMAND gt SELECT FUNCTION gt FUNCTION D DELETE BLANK INQUIRY UPDATE SELECT KEYS SYSLOG ID SCH DATE 960905 RESTORE JOB CONTROL MEMBER NAME gt DATA RETN DAYS gt INDEX RETN DAYS gt Function This screen is displayed when 3 2 is specified in SELECT item of 0 0 0 Initial Menu screen or when 2 is specified in SELECT NUMBER item of 3 0 0 SYSLOG Management screen It is used to specify the selection criteria for selecting SYSLOGs for maintenance It is used for the following operations e Inquiry Update of SYSLOG indexes e Deletion of SYSLOGs e Restoration of SYSLOGs Flow of SYSLOG Index Maintenance Screens The following figure shows the flow of SYSLOG index maintenance screens Legend ENTER Key XXXX Command 3 2 0 3 2 1 3 2 2 1 3 2 2 2 SYSLOG SYSLOG SYSLOG Directory Index Index SYSLOG Index Maintenance Fig 10 9 Screen Flow of SYSLOG Index Maintenance Function A LOG User s Manual 10 63 Chapter 10 A LOG Terminal Operations 10 64 Screen Comma
100. OGDMP2 and ALOGDMP3 utilities based on A LOG Management Database E ALOGDMP2 E ALOGDMP3 Delete job log indexes and data which have passed the retention period E ALOGDMP4 Delete the file created by ALOGDMP1 utility E ALOGJRST Restore job logs and output Dump MT Inquiry List Restore job logs which have been LOG Terminal Facility Delete job logs which have been dumped or have passed the retention period Delete job log indexes and data which have passed the retention period Dump job logs and delete dumped job log data Dump job logs and delete dumped job log data reserved for restoration through A E ALOGDLT4 Delete Dump MT information records which have passed the retention period Retention Management Utilites E ALOGLDMP Dump SYSLOGs and delete dumped SYSLOG data E ALOGLRST Restore SYSLOGs and output Dump MT Inquiry List E ALOGRSEL Restore SYSLOGs which have been reserved for restoration through A LOG Terminal Facility E ALOGDLT1 Delete SYSLOGs which have been dumped or have passed the retention period E ALOGDLTS5 Delete SYSLOG indexes and data which have passed the retention period Fig 7 2 Classification of Utilities for Retention Management Note A LOG Monitor must be terminated before ALOGDMP1 utility is started 7 2 A LOG User s Manual Chapter 7 A LOG Retention Management Facility 7 2 Retention Period 7 2 1 Types of Retention Periods There a
101. Period e Job Class Select Key e Comment 2 SYSLOG Master SYSLOG management information are defined in SYSLOG Master by the user When a SYSLOG is stored into A LOG database a SYSLOG log index is created on the basis of the information defined in SYSLOG Master SYSLOG Master contains the following items e SYSLOG ID e Dump Retention Period e Valid Date e Delete Retention Period e Job Class Select Key e Comment Refer to Chapter 2 A LOG Master Management Facility for further details A LOG Job Log Storage Facility This facility selects specific classes of job logs from OS Spool and stores them into A LOG database It consists of a resident utility named ALOGJLOG that performs the storage of job logs into A LOG database Refer to Chapter 3 A LOG Job Log Storage Facility for further details A LOG SYSLOG Storage Facility A LOG System issues SYSLOG close command WRITELOG command This facility selects specific classes of SYSLOGs which have been closed from OS Spool and then stores them into A LOG database It consists of a resident utility named ALOGSLOG that performs the storage of SYSLOGs into A LOG database Refer to Chapter 4 A LOG SYSLOG Storage Facility for further details A LOG User s Manual 1 3 Chapter 1 A LOG System Facilities A LOG Job Log Print Facility This facility is used to print job logs which have been stored in A LOG database Three methods of printing a job log are supported e
102. S 960831 V380ALOG STC00229 960831 142841 143019 KEEKKKKKERK END OF DATA x x Xx XxXxXxx x SELECT B BROWSE P RESTORE REST ON REST OFF 10 30 A LOG User s Manual Chapter 10 A LOG Terminal Operations Function These screens display the list of job log indexes satisfying the selection criteria as specified in 2 1 0 Job Log Index Maintenance screen The list is sorted in the order of Job Log Storage Date The 2 1 1 1 Job Log Directory and 2 1 1 2 Job Log Directory screens may be displayed by using RIGHT and LEFT commands respectively These screens are used for the following operations e Reference Modify attributes of job log indexes for Job Attribute Information e Reference Modify attribute of job log indexes for SYSOUT Attribute Information e Display of job log data e Printing of job log data e Deletion of job log index and data e Request restoration of job logs e Reserve restoration of job logs e Cancel reservation for restoration of job logs e Search for specific job name Screen Commands To switch to 0 0 0 Initial Menu screen To scroll down one page Trop To display first page of job log index To display last page of job log index To switch to 2 1 1 2 Job Log Directory screen To print job log To cancel reservation of job log restoration A LOG User s Manual 10 31 Chapter 10 A LOG Terminal Operations 10 32 Input Output Items Length 1 Alphanumeric Spe
103. SA JES2 3 1 3 or above Card List Msg ID Msg ID Msg ID Word Word Parameter Parameter Parameter Data Data Data Format Info ID Indicator Keyword Column Length Text Column Length Word Text Column Length Text Column Length Comment pa 2 j solu njis 16 17 24 25 27 28 30 31 sops1 s3 s4 s6 s7 66 67 69 70 72 73 80 Note A A a O PIET x e peresr f os oos po0000 sssopsN Last bytes of SCL list dataset mame name 3 sopst o1 oos wasesa 002 008 HH MMLSS Job start time message AO A O O SS gs Prec IO CA rasan rr meget crer 021 007 mesos CL error message 2 3 ranen o21 oo7 mraz OB FAMED message LL leasc o21_f 09716291402 4 1 Pob cancel message _ amp s osso 002 007 wesss oos _ ystart J f oos YYDDD Job startdate message LL s oseo oo 007 mrsm oos ysrop J oos yYYDDD Fob end date message amp s cono oo 007 mrar oio conncope f oo4 NNNN Conditioncodemessage E a os Wn tem bend code message amp s fuasenb 002 007 wrsm oos users f foom NNNN User abend code message x f o svsour Tow Tos sso o TT O O E E R cic FEF PEER rye yee ye E A LOG User s Manual 3 15 Chapter 3 A LOG Job Log Storage Facility Layout of Job Log Message Definition Card Fujitsu JES Card List Msg ID Msg ID Msg ID Word Word Par
104. SSSSS CATAI CATAI SARC SARC gddddddd LOG DATE FROM LOG TIME FROM JOB NUMBER H CARACTER1 H CARACTER2 Sggggggg O 00 000 000 000 000 000 00 O GG GG GGGGGG GG TITTT 960210 000000 F62N ps Pe a GGGGGG GG GG ny PT PT PT PT PT PT PT PT PT L sLLLLLLGL LOG DATE TO LOG TIME TO Chapter 11 A LOG System Utilities 960210 240000 11 84
105. STORE REST ON or REST OFF command is not DUMP MT UNMATCH REQUIRED DATA REST Either the SYSLOG index specified for REST ON ONI REST OFF command has already been reserved or the reservation of SYSLOG index specified for REST OFF command has already been canceled INPUT INDEXIDATA RETENTION Either a non numerical value has been specified for After DAYS ERROR Restore Index Retention Period or After Restore Data Retention Period or a value exceeding 1831 has been specified RESTORE JCL MEMBER member NOT JCL member of restore job is missing from the DDWTR FOUND ALLOC statement library of the command procedure for A LOG Terminal Facility 10 76 A LOG User s Manual Chapter 10 A LOG Terminal Operations 10 8 System Management Terminal Operations 9 0 0 System Management Screen A LOG 9 0 0 SYSTEM MANAGEMENT 96 09 04 14 22 13 COMMAND gt SEL 1 TERMINAL PF KEYS SETTING Function This screen is displayed when 9 is specified in SELECT item of 0 0 0 Initial Menu screen It is used to set terminal PF keys for a user of A LOG Terminal Facility Screen Operations From this screen you can proceed to 9 1 0 Terminal PF Keys Setting screen as follows Required Item Specification SELECT NUMBER Specify 1 Specify the above and press ENTER key If 9 1 0 Terminal PF Keys Setting screen is protected and you do not have the authority to access to that screen cont
106. SYSLOGs Specified date will be compared against the storage date operation date in SYSLOG indexes Selected SYSLOGs will then be displayed or printed SYSLOG TIME 6 each Numeric Specify a time in hhmmss format as a selection criterion for inquiry or printing of SYSLOGs PRINT OPTION NM Alphabetic Specify P when printing SYSLOGs PRINT JOB NAME 1 Alphanumeric Specify JCL member name of WTRSUTL utility to be submitted for printing SYSLOGs This item must be specified for printing of SYSLOGs PRINT CLASS Alphanumeric Specify SYSOUT class when printing SYSLOGs This item must be specified for printing of SYSLOGs Length A LOG User s Manual 10 55 Chapter 10 A LOG Terminal Operations PRINT MAX LINES Numeric Specify the maximum number of print lines when printing SYSLOG This item must be specified for printing of SYSLOGs Default value is 99999999 PRINT DEST CODE Alphanumeric Specify the destination code to be used in RJE output when printing SYSLOGs DISPLAY LINES 8 each Numeric Specify starting and ending line number for inquiry or printing of SYSLOGs Default starting line number is 00000001 Default ending line number is 99999999 See note 2 Notes 1 e Character string to be searched can only be used at the time of printing of SYSLOG Example F TSO USERMAX is specified Perform print Explanation WTRSUTL utility prints only the line with F TSO USERMAX e Maximum number of
107. System uses the SYSLOG Master to store these attributes and to manage the changes to these attributes The Job Log Master and SYSLOG Master are referenced by ALOGJLOG and ALOGSLOG utility respectively to create a job log or SYSLOG index when a job log or SYSLOG is stored into A LOG database Therefore a user must first defined some master records into Job Log Master and SYSLOG Master before execution of ALOGJLOG or ALOGSLOG utility Registration inquiry deletion and modification of Job Log Master and SYSLOG Master records can be performed using ALOGJMST utility or A LOG Terminal Facility A LOG Terminal Facility A LOG Database Job Log Master Job Log Index SYSLOG Master SYSLOG Index Fig 2 1 A LOG Master Management Functions ALOGJLOG Utility ALOGJMST Utility ALOGSLOG Utility A LOG User s Manual 2 1 Chapter 2 A LOG Master Management Facility 2 1 2 Job Log Master ALOGJLOG utility creates a job log index for each job by referring to the Job Log Master when storing a job log into A LOG database Therefore a user must first define some master records into Job Log before execution of ALOGJLOG utility The attributes of a job log such as class and retention period are defined in Job Log Master The registration screen for Job Log Master and the registration items are shown and explained below A LOG 1 1 2 JOB SYSLOG MASTER INQ UPD 96 11 04 14 07 14 COMMAND gt JOB SYSLOG ID JOBLOG
108. TCO1482 JOBLOG ID JOBLOG DUMP DSNAME ALOG V0380 JDMP VOL SER ALOGO1 LABEL 0001 RESTORE REQUEST RESTORE DATE 960812 RESTORED DATA RESTORED INDEX RETENTION DAYS gt 0001 RETENTION DAYS RESTORE STATUS Eig 7 16 Job Log Index Screen 2 Execute ALOGRSEL utility 7 5 5 ALOGRSEL Utility ALOGRSEL utility is an utility for restoring job logs or SYSLOGs which have reserved for restoration from A LOG Terminal Facility RSELPARM Parameter Ls of Pere or DDJCL DDCNTL e pd ALOGLRST z anagemen atapase ALOGRSEL Utility Dynamic Re e Allocation EN DDRDR SYSPRINT ai ED Internal Reader SYSLOG Dump Proof List A LOG Data Pool ALOGJRST or ALOGLRST Utilit Fig 7 17 ALOGRSEL Utility Processing Outline Refer to ALOGRSEL utility in Chapter 11 A LOG System Utilities for further details 7 22 A LOG User s Manual Chapter 7 A LOG Retention Management Facility It offers the following functions Grouping of Job Logs or SYSLOGs It groups job logs or SYSLOGs that have been reserved for restoration and having the same dataset name label number and the first volume serial number of the Dump MT The JCLs for ALOGJRST or ALOGLRST utility for each group is generated and submitted If the number of job logs or SYSLOGs of one group exceeds 100 it generates and submits the JCLs for every 100 Submission of ALOGJRST or ALOGLRST Utility The member specified in RSELPARM param
109. To display last page of SYSLOG index DELETE To delete SYSLOG index and data RESTORE To restore SYSLOGs REST ON To reserve SYSLOGs for restoration REST OFF To cancel reservation of SYSLOG restoration FIND To search SYSLOG ID continuously Input Output Items tem Lent 1 Alphabetic Specify one of the following operation codes S Reference D Deletion R Mark SYSLOG for restore restore reservation or cancellation SEO ree o Sequence number of SYSLOG index is displayed SYSLOG ID TAE SYSLOG ID is displayed SCH DATE A LOG operation date when storage of SYSLOG started is displayed CATALOG START Storage starting date time of SYSLOG is displayed CPU DATE TIME date time CATALOG END DATE Storage ending date time of SYSLOG is displayed CPU TIME date time PLACE Storage location of SYSLOG data is displayed BKS A LOG Data Pool DUMP MT Dump MT RSTR Restoration status is displayed A No request for restoration ON Restore reservation has been set OFF Restore reservation not set A LOG User s Manual 10 67 Chapter 10 A LOG Terminal Operations 10 68 Screen Operations Reference Modify Attributes of SYSLOG Indexes Required Item Specification lop Specify S for the SYSLOG to be referenced modified Specify the above and press ENTER key 3 2 2 1 SYSLOG Index screen will be displayed for reference modification of the attributes of SYSLOG indexes Deletion of SYSLOG Index and
110. a job log as shown on the left To JOB LOG 1 3 print the first page of SOUT104 specify the SELECT statement as SOUT103 4 4 SELECT DID SOUT104 FPAGE 5 TPAGE 5 SOUT104 5 8 and not as SELECT DID SOUT104 FPAGE 1 TPAGE 1 A LOG User s Manual Chapter 11 A LOG System Utilities Example To print pages 4 to 24 of dataset SOUT0010 of Job SALEJOOI PRINT JOB SALEJ001 MAKED 970114 MAKET 164638 SELECT DID SOUT0010 FPAGE 4 TPAGE 24 2 EXEC Parameters WTRJUTL PARM abcccdddddddd where a Job Log Print Location Specify one of the following L Line Printer S OS Spool 3 Magnetic Tape b must be specified cccc 0000 must be specified dddddddd gt Module name of the Job Log Print exit optional 3 DDJPARM Parameter Card This card is specified in DDJPARM DD statement The format is as follows UTL JOBSEPO YES NO OUTSEPS YES NO JOBSEPC YES NO UNTT unit name where JOBSEPO gt Job Start Separator Print Option YES Print Job Start separator default NO Do not print Job Start separator OUTSEPS gt SYSOUT Start Separator Print Option YES Print SYSOUT Start separator default NO Do not print SYSOUT Start separator JOBSEPC gt Job End Separator Print Option YES Print Job End separator default NO Do not output Job End separator UNIT gt Dump MT unit name Specify the unit name of the Dump MT This parameter is necessary only if the job
111. al number and space requirement for the Job Log Index Release File in the JCL as required 2 Specify the selection criteria and SYSOUT print option in EXEC parameters and 3 Run ALOGBLOG utility 11 2 3 Input Requirement 1 Job Log Index Release File Modify the dataset name volume serial number and space requirement of the Job Log Index Release File in STEP0010 DDBLOG DD statement of the JCL if necessary 11 2 A LOG User s Manual Chapter 11 A LOG System Utilities 2 EXEC Parameters ALOGBLOG PDATE yymmdd yymmdd POUT YES NO PCODE ALL NOR ERR where PDATE gt Storage Date s Specify a single date yymmdd or a range of dates yymmddyymmdd for selecting job log indexes based on Storage Date If a date is not specified the current Operation Date is used POUT gt SYSOUT Print Option YES Print SYSOUT to Audit Trail List Default NO Do not print SYSOUT to Audit Trail List PCODE gt Job Completion Code Type ALL Select job logs with any completion code Default NOR Select job logs with completion code 0 ERR Select job logs with completion code not equal 0 11 2 4 Output Listing A sample output listing of Job Log Audit Trail List is shown on the following page A LOG User s Manual 11 3 Job Log Audit Trail List A LOG JOBLOG L JOB NAME JOB NO 96 06 01 ASMDCD 96 06 02 ASPVWTR 96 06 02 CASPOOL 96 06 02 ASPSRH 96 06 03 ASPSRH kkk kkk TOTAL 73
112. ame Specify Class Specify the output class to OS spool on A LOG 3 1 0 SYSLOG Data Select screen Specify Maximum Number of Lines Specify the maximum number lines that can be printed on A LOG 3 1 0 SYSLOG Data Select screen Specify Destination Code If remote print function is to be used specify the Destination Code on A LOG 3 1 0 SYSLOG Data Select screen Refer to A LOG 3 1 0 SYSLOG Data Select screen in Chapter 10 A LOG Terminal Facility for further details A LOG User s Manual Chapter 6 A LOG SYSLOG Print Facility 6 3 WTRSUTL Utility 6 3 1 Utility Execution WTRSUTL utility can be used to print SYSLOGs There are two ways in which this utility can be executed These are 1 Specify the SYSLOGs to be printed in Print Selection Parameter cards and submit WTRJUTL utility as a batch job 2 Using A LOG Terminal Facility mark and issue print instruction for the SYSLOGs to be printed If SYSLOG data is already dumped onto a Dump MT WTRSUTL utility will automatically request for a tape mount operation If the SYSLOG index is already deleted from A LOG Management database specify the Dump MT in execution JCLs of WTRSUTL utility Print Selection A LOG Management Parameter Database A LOG Terminal Facility m a WTRSUTL Utility LE e Print Instruction SYSLOG A LOG Data Pool Listing Fig 6 2 Execution of WIRSUTL Utility A LOG User s Manual 6 3 Chapter 6 A LOG SYSLOG Print Facility
113. ameter Parameter Parameter Data Data Data Format Info ID Indicator Keyword Column Length Text Column Length Word Text Column Length Text Column Length Comment 1 f 2 js 1011 njis 16 17 24 25s 27 28 30131 5051 s3 s4 s6 s7 66 67 69 70 72 73 80 Note En JCLLST Y 015 006 PS0003 SSSODSN Ie Last 6 bytes of JCL list dataset name name z os OBST on 007 JEM3731 002 oos HH MM SS MMSSS JJ Job start time message start time message A O O IO A A kh he A 7 ee eg a a a E CO EA IET O OO TS S JDJ3751 START Job start date message Ps frown a Poor aoa om Jero P ons vm fbn ane Ps Jeon f o Poor sonar ono feoeo ff mn nn fenton soe ness paco a a We JO Joe oo 07 ra vos fases O e anos oseraies coem 7 pipe eof pon Po A O sour E FERE A LOG User s Manual 3 16 Chapter 3 A LOG Job Log Storage Facility Layout of Job Log Message Definition Card Hitachi JSS3 da ee Es Info ID Indicator Keyword Column Length Text Column Length Word Text Column Length Text Column Length Comment e AA Pf YAA e er EAEN ER EEE Last 6 bytes of JCL list dataset name name z os OBST oz 007 uss464 SS464 002 oos HH MM SS MM SS Job start time message ob start time message A A IO A ear A A oe lt Ri A A ONO A E CO EA E O O IE II II O II O IE ee S JDJ7971 START Job start date message Joe a Poor roma Pom pstor P ons v0 fb
114. an be used to restore dumped job logs from a Dump MT back into A LOG Management Database and A LOG Data Pool USMSJRST Restore A LOG Management Database Parameter Parameter oot USMSCARD DDCNTL DDIN gt ALOGJRST Utility a SYSPRINT Job Log Restore Dump MT A LOG Data Pool Proof List Proof List Fig 7 11 ALOGJRST Utility Processing Outline Refer to ALOGJRST utility in Chapter 11 A LOG System Utilities for further details ALOGJRST utility offers the following functions Select Job Logs for Restoration Job logs to be restored can be selected by specifying the selection criteria in the restore parameter The following selection criteria are supported By job name By job log ID By job log storage date By job log storage time Assign Dump MT for Restoration The Dump MTs to be used for restoration of job logs is automatically assigned from the job log indexes of those job logs specified in restore parameter The maximum number of job logs that can be restored in one execution of ALOGJRST utility is 100 A Dump MT is a dataset containing the job logs dumped by one execution of ALOGJDMP utility or fast dump delete utilities A LOG User s Manual 7 17 Chapter 7 A LOG Retention Management Facility Restore Job Log Data Job log data is restored from Dump MT back into A LOG Data Pool Restore Job Log Index Option It can be specified in a restore parameter whether the job log index of the job log is to
115. and EXIT or MENU 1 0 0 Job Log SYSLOG Master Management 1 1 0 Job Log SYSLOG Master Maintenance 1 1 1 Job Log SYSLOG Master Directory 1 1 2 Job Log SYSLOG Master Fig 10 3 Screen Flow of Job Log SYSLOG Master Management Function A LOG User s Manual 10 11 Chapter 10 A LOG Terminal Operations 1 1 0 Job Log SYSLOG Master Maintenance Screen A LOG 1 1 0 JOB SYSLOG MASTER MAINTENANCE 96 09 04 14 04 49 COMMAND gt SELECT FUNCTION gt FUNCTION JOB SYSLOG ID gt A ADD VALID DATE gt D DELETE COPY ID gt BLANK INQUIRY UPDATE Function This screen is displayed when 1 is specified in SELECT NUMBER item of 1 0 0 Job Log SYSLOG Master Management screen This screen is used to specify the function code and search criteria for performing registration deletion modification and inquiry of Job Log Master or SYSLOG Master records 10 12 A LOG User s Manual Chapter 10 A LOG Terminal Operations Flow of Master Maintenance Screens The following figure shows the flow of master maintenance screens Legend p10 Job Log SYSLOG ENTER Key Master Maintenance O Code in OP Column XXXX Command 1 1 1 Job Log SYSLOG Master Directory 1 1 2 Job Log SYSLOG Master Error Message Fig 10 4 Screen Flow of Master Maintenance Operations Screen Commands MENU To switch to 0 0 0 Initial Menu screen XEXIT To te
116. anual Chapter 11 A LOG System Utilities Format of Data Area of Card ID 4 Format amp Item Name Col Length Description LBP Information 7 Alphanumeric Specify the LBP information This item is treated as a 64 comment in this version of A LOG Master Definition Cards for Deletion 20 21 Unused Format amp No Item Name Col Length Description Master Type Alphabetic Specify J 1 Processing Type Alphabetic Specify D 1 Sequence No 3 Numeric Specify a sequence number to be assigned to each 3 combination of Job Log SYSLOG ID and Valid Date Different types of definition cards belonging to the same Job Log SYSLOG ID and Valid Date must have the same sequence number 1 Job Log 7 Alphanumeric Specify the Job Log SYSLOG ID to be deleted SYSLOG ID 8 Valid Date 15 Numeric Specify the valid date of the job log SYSLOG to be 6 deleted A LOG User s Manual 11 45 Chapter 11 A LOG System Utilities Master Definition Cards for Inquir 1 2 3 80 Format amp No Item Name Col Length Description Master Type peda Specify J i Processing Type i beua Specify L Selection Criteria Alphanumeric Specify the Job Log SYSLOG ID s to be output to Master Inquiry List using one of the following formats JID id To specify a single ID JID id1 id2 To specify multiple IDs JID id1 lt id2 To specify a range of IDs JID ALL To select all IDs Mu
117. at the time of utility execution is used Select Job Logs Using DMPJOB Parameter Job logs that have passed the retention period can be selected for dumping by specifying one or more of the following selection criteria in DMPJOB parameter e By job name e By job log ID e By remaining retention days e By Dump Retention Period Dump Job Log Index and Data Dumping of both job log index and data into a magnetic tape is possible Job log data are compressed at this time Dumping into multiple magnetic tapes up to a maximum of 10 is supported Set Dump MT Information in Job Log Index The dataset name volume serial number label number of Dump MT can be set in the job log index Create Dump MT Information Record A Dump MT Information Record can be created in the Dump MT Information File in A LOG Management Database Refer to 7 4 5 Dump MT Information for further details A LOG User s Manual 7 9 Chapter 7 A LOG Retention Management Facility Generate Dump Proof List An output listing of the job logs which have been dumped can be generated Refer to ALOGJDMP utility in Chapter 11 A LOG System Utilities for further details Delete Job Log Data ALOGJDMP utility consists of the following two 2 steps Step 1 Dump processing is performed Step 2 Job log data which has been dumped are deleted and the cataloging place of job log index is changed from BKS to DUMP MT 7 4 3 Fast Dump Delete Utilitie
118. b log is less than nnn e RETN mmmm nnnn Dump the job log if Remaining Retention Days for the job log is greater than or equal to mmmm and less than or equal to nnnn AAA A LOG User s Manual 11 37 Chapter 11 A LOG System Utilities 11 38 KEEP Numeric Specify the Keep Days This is the number of days that a job log should be 1 4 kept in A LOG Data Pool A job log is dumped if it satisfies the following condition Storage Date Keep Days lt Processing Date PAGE Numeric Specify the maximum number of pages to be dumped ALOGJDMP utility 1 9 will terminate when the total number of pages dumped reached the maximum number When both JOB and JID keywords are specified only job logs with the specified jobname and job number will be dumped Keep Days is used as the Dump Retention Period only if it is greater than the Dump Retention Period of the job log Otherwise the Dump Retention Period of the job log is used Example of Dump Parameter Card DUMP RID JOBLOG JOB SALEJ001 SALEJ002 SALEJ003 RETN 5 Example 1 RETN 4 and reference to A AUTO Holiday Master specified Processing Date 6 17 8 19 20 gue Depa Dump Retention C A Period 5 Dump Retention Period 6 Dump Retention Period 5 Legend MM Storage Date E Retention Period Expire Date The circled number above the arrow indicates the number of working days that the job log has been retained Holida
119. b log will be set to OFF A LOG User s Manual 10 41 Chapter 10 A LOG Terminal Operations Screen Messages INVALID COMMAND An invalid command has been specified DATA CHECK ERROR An error has been detected in the content of an item in job log index DATA SET STORE EXCEED MAX COUNT Number of datasets in a job log has exceeded the maximum OF nnn number allowed RESTORE COMMAND COMPLETE Processing for restore reservation for restore or cancellation of reservation for restore is completed DATA NOT EXIST IN DUMP MT Storage location of the job log for RESTORE REST ON or REST OFF command is not DUMP MT UNMATCH REQUIRED DATA REST Either the job log index specified for REST ON command ONI REST OFF has already been reserved or the reservation of job log index specified for REST OFF command has already been canceled INPUT INDEXIDATA RETENTION Either a non numerical value has been specified for After DAYS ERROR Restore Index Retention Period or After Restore Data Retention Period or a value exceeding 1831 has been specified RESTORE JCL MEMBER member NOT JCL member of restore job is missing from the DDWTR FOUND ALLOC statement library of the command procedure for A LOG Terminal Facility 10 42 A LOG User s Manual Chapter 10 A LOG Terminal Operations 2 1 3 Job Log Index No 2 Screen A LOG 2 1 3 JOBLOG INDEX NO 2 INQ UPD 96 09 04 14 25 55 COMMAND gt JOB NAME V3 80ALOG START
120. base and A LOG Data Pool using 3 2 1 SYSLOG Directory screen Refer to Chapter 10 A LOG Terminal Facility for further details 7 7 3 ALOGDLTS Utility ALOGDLTS utility can be used to delete job logs or SYSLOGs which have passed the retention period A LOG Management Database Holiday OAE ALOGDLTS Master Utility P DDSCT DDBKS EXEC Parameter SYSPRINT Job Log SYSLOG A LOG Data Pool Delete Proof List Fig 7 25 ALOGDLTS Utility Processing Outline Refer to ALOGDLTS Utility in Chapter 11 A LOG System Utilities for further details 7 32 A LOG User s Manual Chapter 7 A LOG Retention Management Facility ALOGDLTS utility offers the following functions Check Retention Period Based on status of job logs or SYSLOGs the index and the data of the job logs or SYSLOGs matching the following conditions are deleted e For job logs or SYSLOGs not yet restored e For restored job logs or SYSLOGs If the Delete Retention Period is less or equal to 29 days and reference to the Holiday Master is specified in EXEC parameter the Holiday Master is referenced for supporting working days as retention period In order to check whether a particular job log or SYSLOG has passed the retention period specify the reference date in EXEC parameter If no reference date is specified the Operation Date at the time of execution of the utility is used Delete Job Logs or SYSLOGs Both index and the data of the
121. between 0000 and 1830 for this item RETENTION DAYS DELETE This item defines the Delete Retention Period i e the number of days a job log and its index are to be retained in A LOG database before it is being deleted by ALOGDLTS utility Specify a 4 digit number between 0000 and 1830 for this item lt gt DESTINATION CODE This item defines the destination code for printing of job logs by RJE function Specify a value up to 8 alphanumeric characters for this item This item is treated as a comment in this version x JOBLOG SYSLOG COMMENT This item defines a user s comment for the job log Specify a value up to 64 alphanumeric characters for this item USER COMMENT This item defines a user s comment for the job log Specify a value up to 64 alphanumeric characters for this item LBP INFO This item defines the information peculiar to a laser beam printer It is treated as a comment in this version Refer to Chapter 10 A LOG Terminal Operations for further details on the operations of Job Log SYSLOG Master screen A LOG User s Manual 2 3 Chapter 2 A LOG Master Management Facility 2 1 3 SYSLOG Master ALOGSLOG utility creates a SYSLOG index by referring to the SYSLOG Master when storing a SYSLOG into A LOG database Therefore a user must first define some master records into SYSLOG Master before execution of ALOGSLOG utility The attributes of a SYSLOG such as class and retention period are defined in SYSLOG Mast
122. characters that can be specified for search is 64 e When searching multiple character strings separate them by comma Character strings are selected based on OR condition Example FABC 001 SSS is specified Explanation Lines containing ABC 001 or SSS is displayed 2 e This line number is a sequential number of the SYSLOG data matching the other conditions Example If there are 5 000 lines of SYSLOG data matching the conditions If 1 is specified as a start line number and 2000 as an ending line number only the first 2 000 will be printed If 2001 is specified as a start line number and 99999999 as an ending line number the lines between 2 001 and 5 000 will be printed e Maximum number of data lines which can be displayed is the value specified in NSLOG of ASPOPTB This value should be in the following range Ending line number start line number 1 lt NSLOG Specification 10 56 A LOG User s Manual Chapter 10 A LOG Terminal Operations Screen Operations Inquiry of SYSLOG Data Specify the search criteria for the selection of SYSLOG records to be displayed such as SYSLOG ID JOB NUMBER SCH DATE SYSLOG TIME and or DISPLAY LINES items then press the ENTER key 3 1 1 SYSLOG Data Inquiry screen will be displayed to show the selected SYSLOG records Printing of SYSLOG Data PRINT PRINT CLASS Specify the SYSOUT class of SYSLOG the SYSOUT class of SYSLOG PRINT MAX L
123. cify one of the following operation codes Inquiry or modify job log attribute information Browse job log data Print job log Delete job log Inquire or modify SYSOUT attribute information Mark job log for restore restore reservation or cancellation ed 4 A PRT is displayed to show that the job log has been specified for printing A RST will be displayed to show that the job log has been specified for restoration pare oblog storage dae is displayed JOBNAME tob mame is displayed 3 Jono Pob mumberis displayed spare obstan dme is displayed sme Pob surt time is displayed erme obendiimeisdisptayed conp Hob completion code is displayed PAGE __ Number of pages of stored job log data is displayed eo iobotsis displayed 333 JOBLOGID voblosIDisdisplived PLACE Storage location of job log data is displayed A Not yet stored or deleted BKS Stored in A LOG Data Pool DUMP MT Stored in Dump MT RSTR Restore status is displayed A No request for restoration ON Restore has been reserved OFF Restore reservation has been canceled JOBLOG ID MIA Job log ID is displayed A LOG User s Manual Chapter 10 A LOG Terminal Operations Screen Operations Reference Modify Attributes of Job Log Indexes for Job Attribute Information Required Item Specification OP Specify S for the jog log to be re
124. column of the job log s for which its reservation for restore is to be canceled A LOG 2 1 1 2 JOBLOG DIRECTORY INQ UPD 96 09 04 14 COMMAND gt REST ON OP MSG DATE JOB NAME JOB NO S DATE S TIME E TIME PLACE RSTR JOB R 960105 V380ALOG STCO00345 960831 152605 152652 BKS JOB R 960105 V380ALOG STC00352 960831 152724 154415 BKS JOB 960107 V380ALOG STC00420 960831 155034 161129 BKS JOB 960107 V380ALOG STC00487 960831 161742 162118 BKS JOB 960107 V380ALOG STC00495 960831 162130 163529 BKS JOB 960812 V380ALOG STC00731 960812 132948 133659 DUMP JOB 960812 V380ALOG STC00758 960812 133754 184431 DUMP 960812 V380ALOG STC01482 960812 185724 190231 DUMP 960813 V380ALOG STC00247 960813 100341 122621 DUMP 960813 V380ALOG STC01326 960813 171248 200230 DUMP 960819 V380ALOG STCO1607 960819 214535 220110 BKS 960819 V380ALOG STC01737 960819 235353 010055 960831 V380ALOG STCO00229 960831 142841 143019 KKKKKKKKKK END OF DATA XXX Xxxx SELECT B BROWSE P RESTORE REST ON REST OFF Fig 7 15 Job Log Directory Screen REST ON command can also be entered from 2 1 2 1 Job Log Index No 1 and 2 1 2 2 Job Log Index No 1 screen In this case it reserves only the job log currently displayed on the screen for restoration A LOG User s Manual 7 21 Chapter 7 A LOG Retention Management Facility A LOG 2 1 2 2 JOBLOG INDEX NO 1 INQ UPD 96 09 04 14 15 36 COMMAND gt REST ON JOB NAME V3 80ALOG LOG DATE 960812 JOB NO S
125. creen A LOG Terminal Facility offers screen commands that are common to all screens as well as screen commands which are peculiar to specific screen only These screen commands may be entered for the COMMAND item of a screen The following screen commands are common to all screens e MENU To switch to 0 0 0 Initial Menu screen e XEXIT To terminate A LOG Terminal Facility PF Key Screen commands may be assigned to PF keys of a terminal using A LOG Terminal Facility Refer to 9 1 0 Terminal PF Keys Setting screen for further details on the setting of screen commands to PF keys Screen Message A LOG Terminal Facility will display messages on a screen when e An error has occurred during starting or ending A LOG Terminal Facility e Anerror has occurred during processing by A LOG Terminal Facility A LOG User s Manual 10 5 Chapter 10 A LOG Terminal Operations 10 6 The following messages may be displayed during starting or ending A LOG Terminal Facility A LOG SYSTEM ID SETTING An error was found in User LOGON ID when opening a screen ERROR A LOG SYSTEM INITIALIZATION An error has occurred during screen initialization ERROR A LOG MAP LIBRARY OPEN An error has occurred while opening screen map library ERROR A LOG MAP map id NOT FOUND Unable to find Map ID in screen map library A LOG SYSTEM ERROR An error has occurred while displaying screen A LOG CMDPROC LENGTH ERROR Length of EXEC parameter for A LOG command
126. ctory Screen cece cece cence scene ence nena ena enee ewes 7 20 Fig 7 14 Job Log Index Screen 0 e eee ee cece een e ence nee eeenaeeeeneees 7 20 Fig 7 15 Job Log Directory Screen ooooooccccnconconccncnnconcnnconnoncnccnnnonnnnos 7 21 Fig 7 16 Job Log Index Screen iscissi ien niine eee a sieaa 7 22 Fig 7 17 ALOGRSEL Utility Processing Outline oooooocccccnccnccnnccncnnos 7 22 Fig 7 18 Calculation of After Restore Index Retention Period 7 24 Fig 7 19 ALOGLRST Utility Processing Outline cece eee eeeee eee 7 26 Fig 7 20 SYSLOG Index Maintenance Screen cesses eee ee sent ees 7 28 Fig 7 21 SYSLOG Directory Screen o ooocooccconconconccncnncnnconconconcnncnnnrnss 7 29 Fig 7 22 SYSLOG Index Screen 2 2 0 0 0 e cee ce eee ne ene ene ence ne en ence ewes 7 29 Fig 7 23 SYSLOG Directory Screen 0 c cece cece eee ee ence neeeeeeeeaennes 7 30 Fig 7 24 SYSLOG Index Screen 2 2 0 0 0 c cece eee e cere ene ence nee ne en enee snes 7 31 Fig 7 25 ALOGDLTS Utility Processing Outline cece eeeee eee 7 32 Fig 7 26 ALOGDLT1 Utility Processing Outline oooooooccccnccnccncccncnnos 7 34 Fig 8 1 A LOG Audit Trail Management Facility ooooccccccccccncccccncncnos 8 1 Fig 9 1 Overview of A LOG Monitoring Facility oooocccnccoccccccncnnnncos 9 1 Fig 9 2 Handling of Job Log at Time of Abend o ooococcccccccconcnccnnccnccn
127. curred while allocating WTRJCL read area ERROR JCL STACKER EXCEED MAX Number of JCL cards has exceeded the maximum number allowed COUNT OF nnn DDNAME DDRDR OPEN ERROR An error has occurred while opening a dataset with DDname DDRDR A LOG User s Manual 10 35 Chapter 10 A LOG Terminal Operations 10 36 DDNAME DDRDR WRITE ERROR An error has occurred while writing a dataset with DDname DDRDR DDNAME DDRDR CLOSE ERROR An error has occurred while closing a dataset with DDname DDRDR JCL STACKER FREEMAIN ERROR An error has occurred while freeing storage area for JCLs JCL READ BUFFER FREEMAIN An error has occurred while releasing read area of WTRJCL ERROR JCL CARD IS MISSING No JCL card is found in WTRJCL DDRDR DYNALLC ER error code An error has occurred while allocating DDRDR dynamically I info code RC return code DDRDR DEALLC ER error code An error has occurred while releasing DDRDR dynamically I info code RC return code DELETE COMMAND ERROR RSP An error has occurred while deleting job log resp code THIS JOBLOG NOT CATALOGED Although job log index exists job log data is not stored THIS JOBLOG EXIST IN DUMP MT Job log data is in Dump MT THIS JOBLOG IS NOT EXIST Job log data does not exist DATA SET STORE EXCEED MAX Number of job log datasets has exceeded the maximum number COUNT OF nnn allowed RECORD SORTING FAILED An error has occurred while sorting job log indexes
128. d PRT is displayed see __ Sequence number of SYSOUT dataset is displayed DATA CODE Dama code of SYSOUT dataset is displayed recem Record format of SYSOUT dataset is displayed rect __ Physical record length of SYSOUT dataset is displayed PAGE FROM TO 6 each Starting Ending page of SYSOUT dataset is displayed This item may be modified by specifying the starting ending page numbers to be printed LINES elo e Number of lines of SYSOUT dataset is displayed PAGES or a Number of pages of SYSOUT dataset is displayed Screen Operations Printing of each SYSOUT dataset Required Item Specification lop Specify P for the SYSOUT dataset to be printed COMMAND Specify PRINT command Specify the above and the page numbers to be printed if any for the PAGE FROM TO columns and press ENTER key Upon completion of the print operation the modified page numbers are reset to the original values A LOG User s Manual Chapter 10 A LOG Terminal Operations Display the data of each SYSOUT dataset Required Item Specification lop Specify B for the SYSOUT dataset to be displayed Specify the above and press ENTER key 2 1 4 Job Log Inquiry screen will be displayed for display of the data for the SYSOUT dataset Screen Messages DDNAME DDWTR OPEN ERROR An error has occurred while opening a dataset with DDname DDWTR WTRNAME veosxxxy NOT FOUND DDNAME
129. d by commas Format amp Keyword Length Description Alphanumeric Specify SYSLOG 6 Alphanumeric Specify the job name of the SYSLOG to be dumped A maximum of 100 job names may be specified in one SYS keyword Note that the SYSLOG is dumped only if the Dump Retention Period is exceeded SID Numeric Specify the job number of the SYSLOG to be dumped A maximum of 1 8 100 job numbers may be specified in one SID keyword Note that the SYSLOG is dumped only if the Dump Retention Period is exceeded Numeric Specify the remaining retention days for selecting SYSLOGs to be 1 4 dumped The remaining retention days is the number of days remaining before the Dump Retention Period is exceeded It is calculated as follows Remaining Retention Days Storage Date Dump Retention Period Processing Date RETN can be specified as follows e RETN nnnn Dump the SYSLOG if the Remaining Retention Days for the SYSLOG is less than nnnn e RETN mmmm nnnn Dump the SYSLOG if Remaining Retention Days for the SYSLOG is greater than or equal to mmmm and less than or equal to nnnn Format amp A LOG User s Manual 11 57 Chapter 11 A LOG System Utilities KEEP Numeric Specify the Keep Days This is the number of days a SYSLOG should be 1 4 kept in A LOG Data Pool A SYSLOG is dumped if it satisfies the following condition Storage Date Keep Days lt Processing Date PAGE Numeric Specify the maximum number of pages to be d
130. d is also created in A LOG Management Database It contains the following information e Volume serial number of the Dump MT e Dump date e Expiration period of Dump MT and e Tape label number of the Dump MT A list of the dumped SYSLOGs is output to SYSLOG Dump Proof List Notes 1 Restored SYSLOG data will not be dumped 2 The maximum number of Dump MTs is 10 11 15 2 Processing Requirement Dump EXEC Parameter Parameters a po eS SYSLOG Dump Proof List Dump MTs E AA SYSLOG Index Information pr ee R ALOGLDMP Holiday a Utility Master A LOG Management Database Dump MT A LOG Data Pool o y Syslog Data Fig 11 18 Processing Outline of ALOGLDMP Utility 11 56 A LOG User s Manual Chapter 11 A LOG System Utilities The procedure for executing ALOGLDMP utility is as follows 1 Specify the Dump parameter cards 2 Specify the A AUTO Holiday Master as required 3 Specify the Dump MT volume serial number processing date and the option to reference A AUTO Holiday Master in EXEC parameters and 5 Run ALOGLDMP utility 11 15 3 Input Requirement 1 Dump Parameter Cards These cards are specified in the DDCNTL DD statement Each card has the following format DUMP keyword value keyword value Each card must begin with DUMP in column 1 Multiple keyword value pairs can be specified on one card by coding them one after another separate
131. described as follows Immediate Print by Dynamic Allocation At the time of storage of job logs ALOGJLOG utility invokes the job log storage exit routine to print specific job logs Selected job logs are output to the DDPRINT DD statement which is dynamically allocated by the exit routine The output class is specified in Job Log Master Also the exit routine can write the job log to any output file Immediate Print by Executing WIRJUTL Utility At the time of storage of job logs ALOGJLOG utility invokes the job log storage exit routine to execute WTRJUTL utility to print specific job logs WTRJUTL utility will print the selected job logs to OS Spool The output class at that time is the SYSOUT class specified in DDOUT DD statement of WTRJUTL utility For the usage of the user exit routine interface refer to A LOG System Administrator s Manual A LOG User s Manual Chapter 5 A LOG Job Log Print Facility 5 3 Print From A LOG Terminal Facility Print instruction may be issued from a terminal for the printing of job logs using A LOG Terminal Facility In this case WTRJUTL utility will be submitted to print the job logs If the job logs to be printed are stored in Dump MT a tape mount request will automatically be issued on console for mounting of the Dump MT There are five instructions for printing job logs using A LOG Terminal Facility These are described as follows Specify a Writer Name Specify a writer name on A LOG
132. dex Retention Days Retention Days SYSLOG Index Retention Days Delete Delete Dump MT Data Information Dump MT Information ALOGDLT4 Utility ALOGDLTS Utility ALOGDLT1 Utility Delete Dump MT Delete Job Log Index amp Data Delete Job Log Information SYSLOG Index amp Data SYSLOG Data A LOG Terminal A LOG Terminal Facility Facility Chapter 7 A LOG Retention Management Facility 7 1 Introduction A LOG Retention Management Facility manages the retention of job logs and SYSLOGs in A LOG database based on retention periods specified for the job logs and SYSLOGs It consists of A LOG system utilities which perform dump restore and deletion of job logs and SYSLOGs These are highlighted in the following diagram ALOGDMP1 4 Fast Dump amp Delete of Job Logs Restore Instruction Modify Index Delete Job Log Index Retention Days Retention Days SYSLOG Index Retention Days Delete Delete Dump MT A S 4 Data Information ALOGDLT4 Utility ALOGDLTS Utility ALOGDLTI1 Utility Delete Dump MT Delete Job Log Index amp Data Delete Job Log Information SYSLOG Index amp Data SYSLOG Data Oe aie Mate fence aga TSO TSS AEN A LOG Terminal A LOG Terminal Facility Facility Fig 7 1 A LOG Retention Management Facility A LOG User s Manual 7 1 Chapter 7 A LOG Retention Management Facility E ALOGJDMP Fast Dump Delete Utilities E ALOGDMP1 Create a file for used by AL
133. e of ALOGDLTS Utility 00 ee 11 14 Fig 11 8 Processing Outline of ALOGDMPC Utility oooooccccccccccccccnncco 11 17 Fig 11 9 Processing Outline of High Speed Dump amp Delete Utilities 11 21 Fig 11 10 Processing Outline of ALOGDMP1 Utility eee 11 22 Fig 11 11 Processing Outline of ALOGDMP2 Utility 0 ee 11 24 Fig 11 12 Processing Outline of ALOGDMP3 Utility eee 11 26 Fig 11 13 Processing Outline ALOGDMP4 Utility o n 11 28 Fig 11 14 Processing Outline of ALOGHOLT Utility ooooo ocnnnccnccnnccnnn oo 11 29 Fig 11 15 Processing Outline of ALOGJDMP Utility ee 11 36 Fig 11 16 Processing Outline of ALOGJMST Utility ee 11 42 Fig 11 17 Processing Outline of ALOGJRST Utility ooooooccccccccccccnncnnoo 11 50 Fig 11 18 Processing Outline of ALOGLDMP Utility oooooocncccccnccnccncos 11 56 Fig 11 19 Processing Outline of ALOGLLOG Utility 0 0 0 0 11 61 Fig 11 20 Processing Outline of ALOGLRST Utility ooooooccccccccnccnccncco 11 64 Fig 11 21 Processing Outline of ALOGRSEL Utility oooooccocccccncninccno oo 11 69 Fig 11 22 Processing Outline of WTRJUTL 2 0 0 0 ccc cece eee ee eee 11 73 Fig 11 23 Processing Outline of WIRSUTL occ cece eee eee es 11 79 A LOG User s Manual v Preface This manual is designed for all A LOG users in general It explains in detail the facilities provided by A LOG system
134. e os IEBCOPY JOB00104 Job Log One Execution of WTRJUTL Utility IEBCOPY JOB00104 IDCAMS JOB00200 Job Log IDCAMS JOB00200 Fig 5 2 If N specified for Writer Submission by Job 5 4 A LOG User s Manual Chapter 5 A LOG Job Log Print Facility ASPASM JOB00100 Job Start Separator Job L 1 Execution of 2 WTRJUTL Utility ASPASM JOB00100 Job End Separator IEBCOPY JOB00104 rah 2 Execution of ee WTRJUTL Utility IEBCOPY JOB00104 E If n job logs are marked for printing WTRJUTL utility will be executed n times IDCAMS JOB00200 h n Execution of Job Log WTRJUTL Utility IDCAMS JOB00200 Fig 5 3 If Y specified for Writer Submission by Job A LOG User s Manual 5 5 Chapter 5 A LOG Job Log Print Facility 5 4 WTRJUTL Utility 5 4 1 Utility Execution WTRJUTL utility can be used to print job logs There are two ways in which this utility can be executed These are 1 Specify the job logs to be printed in Print Selection Parameter cards and submit WTRJUTL utility as a batch job 2 Using A LOG Terminal Facility mark and issue print instruction for the job logs to be printed If job log data is already dumped onto a Dump MT WTRJUTL utility will automatically request for a tape mount operation If the job log index is already deleted from A LOG Management database specify the Dump MT in execution JCLs of WTRJUTL utility
135. e value specified in INDEX RETN DAYS item of A LOG 2 1 0 Job Log Index Maintenance screen A LOG User s Manual 3 2 3 SYSOUT Attribute Information Chapter 3 A LOG Job Log Storage Facility SYSOUT attribute information are displayed on A LOG 2 1 3 screen as follows A LOG 2 1 3 JOBLOG INDEX NO 2 INQ UPD COMMAND gt JOB NAME V3 80ALOG JOB JOB NO STCO0345 JOB COND CODE 0000 LOG DATA CODE RECFM LRECL JOBLOG FM 00137 SOUTO101 00121 SOUTO103 00133 KKKKKKKK START DATE TIME END DATE TIME DATE PAGE FROM TO 000001 000001 000002 000002 000003 000003 96 11 04 14 25 55 961031 152605 961031 152652 700105 LINES PAGES 00000174 000001 00000009 000001 00000024 000001 Fig 3 4 SYSOUT Attribute Information Screen osname Prey r o TT 108 START DATETIME CPU dine in yond ims ormat wien area COS Perrera A COND CODE Highest completion code from among the completion codes of each job step LOG DATE A LOG operation date when the job log is stored Specify operation code e P lt XIPrint the job log data e B lt XIBrowse the job log data Sequence number of the job log dataset DATA CODE Data Code of the SYSOUT dataset RECFM Record format of the SYSOUT dataset LRECL Logical record length of the SYSOUT dataset PAGE FROM TO Starting and ending page numbers of the SYSOUT dataset LINE S Total number of lines of the SYSOUT dataset PAGES Total number of pages of the SYSOUT data
136. ecords e Listing of master records Job Log Master Master ALOGJMST Definition Cards Utility SYSLOG Master 4 A A LOG Management Database Master Directory Fig 2 4 ALOGJMST Utility Processing Outline Refer to Chapter 11 A LOG System Utilities for further details on the operations ALOGJMST utility 2 6 A LOG User s Manual Chapter 3 A LOG Job Log Storage Facility OS Spool Job Log 1 Job Log 2 Specific Classes of Job Logs Job 1 Execution Job 2 Execution Reference ALOGJLOG Utility Resident Program A LOG Management Database Job Log Job Log Master Index A LOG Terminal Facility Create A LOG Data Pool Job Log Data 1 Job Log Data 2 e Inquiry e Print Instruction Chapter 3 A LOG Job Log Storage Facility 3 1 Introduction Storage of job logs into the A LOG database is performed by ALOGJLOG utility This utility is a resident program It selects specific classes of job logs from the OS Spool and then stores the selected job logs into A LOG database For each job log stored into A LOG database a job log index is also created and managed by A LOG System OS Spool Job Log 1 Job Log 2 Job 1 Execution Job 2 Execution Job Log Data 1 Job Log Data 2 LLEN e Inquiry e Print Instruction Fig 3 1 A LOG Job Log Storage Facilit A LOG User s Manual 3 1 Chapter 3 A LOG Job Log Storage Facility 3 2 Job Log Inde
137. ed Conditions for retention management by Working Date e When the retention period is less than or equal to 29 days and e When reference to a Holiday Master is specified in EXEC parameter Conditions for retention management by Calender Date e When the retention period is 30 days or more or e When reference to a Holiday Master is not specified in EXEC parameter For retention management by Working Date the non operation days must be defined in Holiday Master Refer to ALOGHOLT utility in Chapter 11 A LOG System Utilities for further details A LOG User s Manual 7 7 Chapter 7 A LOG Retention Management Facility 7 4 Dumping of Job Logs or SYSLOGs 7 4 1 Introduction A LOG database is a limited resource in terms of storage space Therefore it is necessary to dump job logs or SYSLOGs that are no longer required into a magnetic tape periodically After dumping they can be deleted from the A LOG database The A LOG system utilities for dumping job logs or SYSLOGs are listed as follows 1 ALOGJDMP Utility It dumps job logs into a magnetic tape 2 Fast Dump Delete Utilities They dump job logs into a magnetic tape 3 ALOGLDMP Utility It dumps SYSLOGs into a magnetic tape The difference between 1 and 2 is explained in 7 4 2 Fast Dump Delete Utility The job logs or SYSLOGs which have been dumped into a magnetic tape can still be printed by a user if their job log or SYSLOG indexes remained in A LOG Manag
138. ed to select the job log to be printed A SELECT statement is used to select the dataset within the job log to be printed If a PRINT statement is not followed by a SELECT statement the entire job log is printed If a PRINT statement is followed by a SELECT statement only the specified dataset of the job log is printed Two or more SELECT statements may be specified for each PRINT statement PRINT Statement Format PRINT JOB jobname MAKED yymmdd MAKET yymmdd SEQ store sequence no where JOB Job name of the job log to be printed MAKED gt Storage Date of the job log MAKET gt Storage Time of the job log Specify this parameter in the case where there are multiple job logs with the same job name and Storage Date SEQ Storage Sequence Number Specify this parameter in the case where there are multiple job logs with the same job name Storage Date and Storage Time The first of these job logs to be stored has sequence number 1 the second has sequence number 2 and so on SELECT Statement Format SELECT DID dataset code F PAGE from page no TPAGE to page no where DID gt Dataset Code of the dataset to be printed FPAGE TPAGE gt From and to page numbers Specify these parameters to print a range of pages of the specified dataset Both FPAGE and TPAGE must be specified These page numbers are relative to the start of the job log and not to the start of the dataset Dataset Code Page No For example assume
139. ed in DDJCL DD statement as follows DDJCL DD DSN sample restore job library DISP SHR 3 Create Sample Restore Job Create the sample restore job into the library specified in 2 This sample job should be modeled after ALOGJRST ALOGLRST utility 11 18 4 Output Listing A sample output listing of Restore Job Creation Proof List is shown on the following page A LOG User s Manual 11 71 Chapter 11 A LOG System Utilities Restore Job Creation Proof List A LOG ADVANCED JOBLOG SYSLOG MANAGEMENT SYSTEM VERSION 03 80 BY BSP INC DATE 96 02 14 TIME 15 16 11 PROOF LIST OF RESTORE SELECT JOBLOG LIST CODE RSEL100 J k Me JOB SEQ 1 DUMP MT TOP VOLSER C91048 LABEL 001 DSNAME ALOG V0380 JDMP lt gt 9 py JOB NAME J JOBI M DATE CAT DATE DUMP VOLSER CURRENT SGEN0005 JOB01529 JOBI 96 01 25 96 01 25 C92048 SGEN0005 JOB01514 JOBI 96 01 25 96 01 25 t C92048 SPLLOOO1 JOB01567 JOBI 96 01 25 96 01 25 t C92048 SPLLO002 JOB01573 JOBI 96 01 25 96 01 25 C92048 SPLLO003 JOB01574 JOBI 96 01 25 96 01 25 f C92048 SGEN0004 JOB01575 JOBI 96 01 25 96 01 25 H C92048 Sequence Number of Restore Job Unit Job Log SYSLOG Storage Time First Volume Serial Number of Dump MT Number of Pages of Job Log SYSLOG Label Number of Dump MT Volume Serial Number of Dump MT where Job Log SYSLOG is Dumped Dataset Name of Dump MT Sequence Number of Job Log SYSLOG withi
140. efinition card A job log index is created based on the information contain in the referenced Job Log Master record If no Job Log Master record is selected from Job Log Master for the job log ALOGJLOG utility will create the job log index based on the default Job Log Mater record Job Log ID JOBLOG When a job log index is created based on default Job Log Master record the Job Log ID is determined as follows 1 The Job Log ID is set to blank if a job definition card is not specified 2 The Job Log ID is set to JOBLOG if the criteria specified in the job definition card is not satisfied 3 If the criteria of a job definition card are satisfied but the master record is not defined the Job Log ID is set to the Job Log ID specified in the job definition card A LOG User s Manual 3 7 Chapter 3 A LOG Job Log Storage Facility Job Definition Cards Job Log Message Definition Cards DDJLOG ifi DDCATJ DDCAT ee EXEC Parameter Parameter Y DDWTR JCLs for WTRJUTL Job Log Storage DDJEXT Utility Exit Routine gt ALOGJ LOG Module Name Utility Job Log SYSUTI Work File JCL Modification Exit Routine Module Name DDJUTL Job Log Data Job Log Job Log Master Index A LOG Management Database A LOG Data Pool Fig 3 5 ALOGJLOG Utility Processing Outline 3 4 2 Description of Specification Items EXEC Parameters ALOGJLOG CLASS class P job definition ca
141. election criteria if any and press ENTER key A list of master records satisfying the selection criteria will be displayed on 1 1 1 Job Log SYSLOG Master Directory screen for deletion of Job Log Master or SYSLOG Master records Inquiry Update of a Job Log Master or SYSLOG Master Record A list of master records satisfying the selection criteria will be displayed on 1 1 1 Job Log SYSLOG Master Directory screen for inquiry update of Job Log Master or SYSLOG Master records Screen Messages CALLED SCREEN NOT FOUND The function associated with the specified menu number is not available INVALID COMMAND An invalid command has been specified JOBLOG ID DUPLICATE ERROR A job log or SYSLOG master record with the same job jog or SYSLOG ID and valid date already exists COPY JOBLOG ID NOT FOUND The job log or SYSLOG master record serving as a copy source for a job log or SYSLOG master record to be added is not found RECORD NOT FOUND No job log or SYSLOG master record satisfying the specified search criteria is found INVALID FUNCTION An invalid function code has been specified VALID DATE ERROR An invalid date has been specified JAM FILE FIND ERROR RSP xxx An error response code RSP xxx was returned while inquiring into the Job Log Master or SYSLOG Master JAM STORE EXCEED MAX The store count of Job Log Master or SYSLOG Master has exceeded COUNT OF nnn the maximum count of nnn n n n CALLED SCREEN LOAD An error has occurred
142. ement Database The magnetic tape containing the dumped job logs or SYSLOGs is called a Dump MT 7 4 2 ALOGJDMP Utility ALOGJDMP utility is an utility for dumping job logs which have passed the specified retention period into a Dump MT DMPJOB A LOG Management Database Parameter EXEC DDCNTL Parameters i HOLTABLE Holiday r ALOGJDMP Master Utility DDOUT SYSPRINT Job Log Dump A LOG Data Pool Proof List Fig 7 5 ALOGJDMP Utility Processing Outline Refer to ALOGJDMP utility in Chapter 11 A LOG System Utilities for further details A LOG User s Manual Chapter 7 A LOG Retention Management Facility ALOGJDMP utility provides the following functions Check Retention Period It calculates the last day of the retention period of every job log based on the storage date of the job log and the Dump Retention Period specified in job log index It then selects the job logs which have passed the retention period and dump the job logs to a Dump MT The job logs which have been restored once cannot be dumped again Reference to a Holiday Master is required under the following conditions e When the Dump Retention Period is less than or equal to 29 days or e When reference to Holiday Master is specified in EXEC parameter The reference date for checking whether the retention period has passed can be specified in the EXEC parameter If the reference date is not specified the Operation Date
143. ently displayed dataset z nin A LOG User s Manual 10 47 Chapter 10 A LOG Terminal Operations 10 48 Input Output Items A a O O bo permet spare fobsurdavisdigpnyed OOOO O O cond a ote ise O Tr Data code is displayed PAGE F Starting page of current SYSOUT dataset is displayed PAGE T Ending page of current SYSOUT dataset is displayed pcope ET tel ee Current page number is displayed Forefront line number of current data is displayed Forefront column position of current data is displayed Physical record length of the current SYSOUT dataset is displayed CU Screen Operations Scrolling of Job Log Data Required Item COMMAND Specify the appropriate command for scrolling the data Specify a valid command and press ENTER key Searching for Specific Character Strings Required Item Specification COMMAND Specify F string start page end page command Specify the above and press ENTER key The line containing the character string will be displayed Up to a maximum of 18 characters can be specified in the character string If the character string contains an embedded blank enclose the character string with quotes If the search range starting and ending page is specified the search is performed only within the specified range If only the starting page is specified the search is performed from the specified starting page until the last page
144. er The registration screen for SYSLOG Master and the registration items are shown and explained below A LOG 1 1 2 JOB SYSLOG MASTER INQ UPD 96 11 04 14 07 14 COMMAND gt JOB SYSLOG ID VALID DATE SYSOUT CLASS JOB CLASS RETENTION DAYS RETENTION DAYS DUMP DELETE DESTINATION CODE gt JOB SYSLOG COMMENT gt JOBLOG COMMENT USER COMMENT gt USER COMMENT LBP INFO gt LBP INFORMATION EERE A E E A A A A E A Ore ta 6i 58 Fig 2 3 SYSLOG Master Registration JOBLOG SYSLOG ID This item defines an identifier for a SYSLOG Master record Specify a value up to 8 alphanumeric characters for this item VALID DATE This item defines the effective date of a SYSLOG Master record Specify a valid date in yymmdd format for this item Note that a SYSLOG Master record is uniquely identified by its SYSLOG ID and Valid Date SYSOUT CLASS This item is treated as a comment in this version A LOG User s Manual Chapter 2 A LOG Master Management Facility JOB CLASS This item defines the job class of a SYSLOG Master record It is used for selection of SYSLOGs Specify an unique alphanumeric character for this item Note that this item has no relationship with the SYSOUT CLASS item RETENTION DAYS DUMP This item defines the Dump Retention Period i e the number of days a SYSLOG is to be retained in A LOG database before it is being dump by ALOGLDMP utility Specify a 4 digit numb
145. er between 0000 and 1830 for this item RETENTION DAYS DELETE This item defines the Delete Retention Period i e the number of days a SYSLOG and its index are to be retained in A LOG database before it is being deleted by ALOGDLTS utility Specify a 4 digit number between 0000 and 1830 for this item lt gt DESTINATION CODE This item defines the destination code for printing of SYSLOGs by RJE function Specify a value up to 8 alphanumeric characters for this item This item is treated as a comment in this version x JOBLOG SYSLOG COMMENT This item defines a user s comment for the SYSLOG Specify a value up to 64 alphanumeric characters for this item USER COMMENT This item defines a user s comment for the SYSLOG Specify a value up to 64 alphanumeric characters for this item LBP INFO This item defines the information peculiar to a laser beam printer It is treated as a comment in this version Refer to Chapter 10 A LOG Terminal Operations for further details on the operations of Job Log SYSLOG Master screen A LOG User s Manual 2 5 Chapter 2 A LOG Master Management Facility 2 2 ALOGJMST Utility This utility maintains the master records in Job Log Master as well as SYSLOG Master The utility reads master definition cards as input and performs one or more of the following master record maintenance functions e Registration Deletion of Job Log Master records e Registration Deletion of SYSLOG Master r
146. er string to be compared with the job 44 name using the following criteria EQ amp Equal GE lt XIGreater Than or Equal LE lt amp lLess Than or Equal NE lt amp INot Equal GT lt XIGreater Than LT lt amp lLess Than lt I Combining expressions with AND operator all criteria matched lt X Combining expressions with OR operator any criterion matched A LOG User s Manual 3 9 Chapter 3 A LOG Job Log Storage Facility Examples JOB ID OOOLEN CLASS COL LEN JOBNAME EQ X GE X LE X NE X GT X LT X AND OR 000002JU 007002LE 19 AND GE 00 PSJOBLOGB 000002JT 007002LE 29 AND GE 20 PSJOBLOGC 000001J 007002LE 39 AND GE 30 PSJOBLOGD 000001J 007002GE 40 PSJOBLOGCT 000001J 004003EQ CAT PSJOBLOGWT 0000010 004003EQ WTR PSJOBLOGSP 0000010 004003EQ SPM PSJOBLOGAS 0000010 001003EQ ASP PSJOBLOG99 0000010 000000 Notes 1 The first 2 lines are comment lines 2 The third line means SYSOUT class is J or U If the 2 characters from the 7th character of a job name is 00 19 refer to the Job Log Master record with Job Log ID equals JOBLOGA In the above example the Job Log Master records that will be referenced for the following job names and SYSOUT class are shown SYSOUT Class Job Log Master Report3 K SOBLOG default Report 1 f ose usecamoa 1 f oser The underlined portion is the criteria to be specified in the parameter Job Log Message Definition
147. erations Inquiry Update of a SYSLOG Indexes Specify the selection criteria if any and press ENTER key 3 2 1 SYSLOG Directory screen will be displayed with a list of selected SYSLOG indexes for inquiry update of SYSLOGs AX Deletion of a SYSLOGs Required Item Specification SELECT FUNCTION Specify D Specify the above and selection criteria if any and press ENTER key 3 2 1 SYSLOG Directory screen will be displayed with a list of selected SYSLOG indexes for deleting of SYSLOGs Nk Restoration of SYSLOGs Specify the selection criteria and RESTORE JOB CONTROL items if any and press ENTER key 3 2 1 SYSLOG Directory screen will be displayed with a list of selected SYSLOG indexes for restoration of SYSLOGs Screen Messages CALLED SCREEN NOT FOUND The function associated with the specified menu number is not available INVALID COMMAND An invalid command has been specified n n n CALLED SCREEN LOAD ERROR An error has occurred while loading screen module with menu number n n n INPUT INDEXIDATA RETENTION Either a non numerical value has been specified for After DAYS ERROR Restore Index Retention Period or After Restore Data Retention Period or a value exceeding 1831 has been specified A LOG User s Manual 10 65 Chapter 10 A LOG Terminal Operations 10 66 3 2 1 SYSLOG Directory Screen SYSLOG DIRECTORY INQ UPD 96 09 04 14 19 29 SYSLOGID SCH DATE CATALOG START CATALOG END PL
148. eter member of library of DDJCL DD statement is a standard JCL If the specified member name does not exist in the library the member name ALOGJRST or ALOGLRST of the same library is used as the standard JCL The execution job name at the time of submission is replaced by the specified member name The job logs or SYSLOGs information After Restore Data Retention Period and After Restore Index Retention period as specified in RSELPARM parameter are set into the DDCNTL DD statement of the standard JCLs restore parameter Generate Output Listing An output listing of the contents of the generated restore parameter is generated 7 5 6 Default Values for After Restore Index Retention Period and After Restore Data Retention Period Default values are set for After Restore Index Retention Period and After Restore Data Retention Period if they are omitted in the specification Default Value for After Restore Index Retention Period Default value is calculated based on the Delete Retention Period or the previous After Restore Index Retention Period as follows e Restoring both index and data for the first time After Restore Index Retention Period Job Log SYSLOG Storage Date Delete Retention Period A LOG Utility Operation Date A LOG User s Manual 7 23 Chapter 7 A LOG Retention Management Facility e Restoring data from the second time onwards After Restore Index Retention Period Previous Restore Date Pr
149. evious After Restore Index Retention Period A LOG Utility Operation Date Feb 10 Feb 11 Feb 12 Feb olen de Feb 14 Feb Feb15 Feb a Feb 17 17 Feb 18 18 Feb 19 19 Restored O eres Retention Period 3 Days Legend e Storage Date m Restore Execution Calculation After Restore Index Retention Period 10 Days 7 Days 14 Days 3 Days Fig 7 18 Calculation of After Restore Index Retention Period Default Value for After Restore Data Retention Period Default value is 0 7 5 7 Dump MT Inquiry List The list of job logs or SYSLOGs dumped to the Dump MT is called the Dump MT Inquiry List This list is generated by the execution of ALOGJRST or ALOGLRST utility The generation of a Dump MT Inquiry List and the restoration of job logs or SYSLOGs cannot be performed at the same time When generating a Dump MT Inquiry List the Dump MT must be specified in DDIN DD statement Refer to ALOGJRST or ALOGLRST utility in Chapter 11 A LOG System Utilities for further details 7 24 A LOG User s Manual Chapter 7 A LOG Retention Management Facility 7 6 Restore of SYSLOGs 7 6 1 Introduction SYSLOGs which have been dumped by ALOGLDMP utility can be restored back into A LOG Management Database and A LOG Data Pool There are three 3 methods for restoring SYSLOGs e By ALOGLRST Utility e By restore instruction from A LOG Terminal Facility e By restore reservation from A LOG Terminal Facility If the SYSLOG index is in
150. ex Maintenance screen is protected and you do not have the authority to access to that screen control is returned to this screen after pressing the ENTER key A LOG User s Manual Flow of SYSLOG Management Screens Chapter 10 A LOG Terminal Operations The following figure shows the flow of SYSLOG management screens 0 0 0 Legend xxxx Command 3 0 0 3 1 0 SYSLOG Data Select 3 1 1 SYSLOG Data Inquiry EXIT or MENU Management 3 2 0 SYSLOG Index Maintenance 3 2 1 SYSLOG Directory 3 2 2 1 2 SYSLOG Index Fig 10 7 Screen Flow of SYSLOG Management Function A LOG User s Manual 10 53 Chapter 10 A LOG Terminal Operations 3 1 0 SYSLOG Data Select Screen A LOG 3 1 0 SYSLOG DATA SELECT 96 09 04 14 17 20 COMMAND gt SELECT KEYS PRINT KEYS SYSLOG ID JOB NUMBER J JOB S STC T TSU FIND CHARACTER STRINGS SCH DATE gt 960905 gt 960905 SYSLOG TIME 135720 gt 141720 PRINT OPTION P PRINT UTILITY EXECUTE PRINT JOB NAME PRINT CLASS C PRINT MAX LINES 99999999 PRINT DEST CODE gt LOCAL DISPLAY LINES 00000001 gt 00000100 Function This screen is displayed when 3 1 is specified in SELECT item of 0 0 0 Initial Menu screen or when 1 is specified in SELECT NUMBER item of 3 0 0 SYSLOG Management screen Generally search criteria for SYSLOG data print criteria and instructions for SYSLOG data are specified using this scree
151. f the job log or SYSLOG master record to be registered VALID DATE Specify a valid date for the job log or SYSLOG master record to be registered COPY ID During registration specify a job log or SYSLOG ID of job log or SYSLOG master record to be copied Specify the above and press ENTER key Processing depends on the following conditions e If there is only one Job Log Master or SYSLOG Master record with the specified job log or SYSLOG ID for copying contents of the master record to be copied will be displayed on 1 1 2 Job Log SYSLOG Master screen After changing the contents enter SAVE command and press ENTER key Registration of master record by copying is performed accordingly e If there are multiple Job Log Master or SYSLOG Master record with the specified job log or SYSLOG ID for copying a list of those master records is displayed on 1 1 1 Job Log SYSLOG Master Directory screen Specify S in the OP column for any of the listed master records and press the ENTER key Contents of the master record to be copied will be displayed on 1 1 2 Job Log SYSLOG Master screen After changing the contents enter SAVE command and press ENTER key Registration of master record by copying is performed accordingly A LOG User s Manual 10 15 Chapter 10 A LOG Terminal Operations Deletion of a Job Log Master or SYSLOG Master Record Required Item Specification SELECT FUNCTION Specify D Specify the above and the s
152. ferenced modified Specify the above and press ENTER key 2 1 2 1 Job Log Index No 1 screen will be displayed for reference modification of the attributes for Job Attribute Information Reference Modify Attribute of Job Log Indexes for SYSOUT Attribute Information Required Item Specification OP Specify O for the jog log to be referenced modified Specify the above and press ENTER key 2 1 3 Job Log Index No 2 screen will be displayed for reference modification of the attributes for SYSLOT Attribute Information Display of Job Log Data Required Item Specification OP Specify B for the jog log to be displayed Specify the above and press ENTER key 2 1 4 Job Log Inquiry screen will be displayed for display of the job log data Printing of Job Log Data Required Item Specification OP Specify P for the jog log to be printed COMMAND Specify PRINT command Specify the above and press ENTER key WTRJUTL utility will be submitted for printing the job log data The writer name specified in WRITER NAME field of 2 1 0 Job Log Index Maintenance screen is used for submission Upon successful submission of WTRJUTL utility the message PRT will be displayed in the MSG column of the job logs A LOG User s Manual 10 33 Chapter 10 A LOG Terminal Operations 10 34 Deletion of a Job Log Index and Data Required Item Specification OP Specify D for the j
153. first before this utility A LOG Monitor must be started before executing this utility Otherwise the utility will display the message SSB101I ALOG IS NOT ACTIVE on the console every 10 seconds until A LOG Monitor is started 11 10 3 2 Processing Requirement 11 26 A LOG Management Database E gt Job Log Index EXEC Parameter Dump MT A LOG Data Pool Information ae aa Job Log Data Job Log Index l ALOGDMP3 All Job Logs Job Log Index Deletion Proof List Utility SS Job Log Data Index Holiday Master Fig 11 12 Processing Outline of ALOGDMP3 Utility A LOG User s Manual Chapter 11 A LOG System Utilities The procedure for executing ALOGDMP3 utility is as follows 1 Specify the A AUTO Holiday Master as required 2 Specify the processing date and the option to reference A AUTO Holiday Master in EXEC parameter and 3 Run ALOGDMP3 utility 11 10 3 3 Input Requirement 1 Holiday Master Specification The required Holiday Master is specified in HOLTABLE DD statement as follows HOLTABLE DD DSN holiday master dataset name member name DISP SHR 2 EXEC Parameters ALOGDMP3 PDATE yymmdd HOLIDAY Y N where PDATE gt Processing Date Specify the processing date in yymmdd format If omitted the current A LOG i Operation Date is used HOLIDAY gt Holiday Master Reference Option Y Holiday Master is referenced N Do not refere
154. for Writer Submission by Job 0 eeee eee 5 4 Fig 5 3 If Y specified for Writer Submission by Job cece eee 5 5 Fig 5 4 Execution of WTRJUTL Utility 2 00 e cence eeee ees 5 6 Fig 6 1 A LOG SYSLOG Print Facility o oooococccccnccnconccnconconcnononcnncos 6 1 Fig 6 2 Execution of WTRSUTL Utility oooococcccccccnconccnccncnncnnccncnncnos 6 3 Fig 7 1 A LOG Retention Management Facility o oooooccocccccnccnccnncnncnos 7 1 Fig 7 2 Classfication of Utilities for Retention Management 7 2 Fig 7 3 Status of Job SYSLOG and Retention Period eee eee 7 4 A LOG User s Manual iii Table of Contents iv List of Figures Fig 7 4 Correlation between Retention Period amp Utilities 7 5 Fig 7 5 ALOGJDMP Utility Processing Outline cece cece eee eee eee 7 8 Fig 7 6 Structure of Fast Dump Delete Utilities eee eee 7 10 Fig 7 7 Fast Dump Delete Utilities Processing Outline eee 7 11 Fig 7 8 ALOGLDMP Utility Processing Outline ccc cence eee 7 12 Fig 7 9 Dump MT Inquiry cece cece cece eee eee ii ii 7 14 Fig 7 10 ALOGDMPC Utility Processing Outline cece eee eee eee 7 15 Fig 7 11 ALOGJRST Utility Processing Outline o n 7 17 Fig 7 12 Job Log Index Maintenance Screen cece ee ee ence eeeee eee eee 7 19 Fig 7 13 Job Log Dire
155. g processing types C Register R Update D Delete Inquire tial Holiday ID ial ea Specify the Holiday ID ail Numeric Specify the year and month in yymm format A This item is required for registration and update functions For deletion function if this item is specified the Holiday Master information for the specified year and month is deleted If omitted all Holiday Master information for the specified Holiday ID are deleted This item is ignored for inquiry function Examples 1 Register Holiday Master information for Holiday ID ALOGHOLT for the period July to December 1997 PE EAE E OAE CALOGHOLT9707 CALOGHOLT9708 CALOGHOLT9709 CALOGHOLT9710 CALOGHOLT9711 CALOGHOLT9712 11 30 A LOG User s Manual Chapter 11 A LOG System Utilities 2 Delete all Holiday Master information for Holiday ID ALOGHLT1 and delete Holiday Master information for Holiday ID ALOGHLT2 for the period January to April 1997 Wang dha ots wlan og A A A op glen ooh toh on ond A og ay og hae gas A A gtr arash athe eG DALOGHLT1 DALOGHLT29701 DALOGHLT29702 DALOGHLT2 9703 DALOGHLT29704 3 Update Holiday Master information for Holiday ID ALOGHLT1 for August 1997 Sees Gaede AS AAA E AD A SEIS ARA L A O ASAI A AS 11 11 11 11 E RALOGHLT19708 4 Inquire Holiday Master information for Holiday IDs ALOGHLT1 and ALOGHLT2 EE a ES AR AD A ce Wid eh rng a greek pig a AO IALOGHLT1 IALOGHLT2
156. gt JOB NAMI SYSLOG LOG DATE 960815 JOB NO STC00001 SYSLOG ID SYSLOG DUMP DSNAME ALOG V0380 LDMP VOL SER ALOGO1 LABEL 0002 ESTORE REQUEST ON RESTORE STATUS ESTORE DATE ESTORED DATA RESTORED INDEX RETENTION DAYS gt 0000 RETENTION DAYS gt 0000 A LOG User s Manual 10 71 Chapter 10 A LOG Terminal Operations 10 72 Function These screen display the attribute information of a SYSLOG index The 3 2 2 1 SYSLOG Index and 3 2 2 2 SYSLOG Index screens may be displayed by using UP and DOWN commands respectively These screens are used for the following operations e Modify attributes of a SYSLOG index e Request restoration of a SYSLOG e Reserve restoration of a SYSLOG e Cancel reservation for restoration of a SY SLOG Screen Commands To switch to 0 0 0 Initial Menu screen EXIT a A SAVE To update SYSLOG index EMSG To switch to Error Message screen UP To switch to 3 2 2 1 SYSLOG Index screen DOWN To switch to 3 2 2 2 SYSLOG Index screen RESTORE To restore SYSLOGs REST ON To reserve SYSLOGs for restoration REST OFF To cancel reservation of SYSLOG restoration Input Output Items JOB NAME Mais Job name of SYSLOG is displayed LOG DATE A LOG operation date when the storage of SYSLOG was started is displayed JOB NO ogno f Job number of SYSLOG is displayed Job number of SYSLOG is displayed SYSLOG ID SYSLOG ID of SYSLOG Ma
157. gt 0007 DUMP DELETE DESTINATION COOD gt LOCAL SYSOUT DEFINE gt JOBLOG COMMENT AJOB0002 MASTER USER COMMENT LBP INFO Job Log SYSLOG ID lt gt Destination Code Valid Date x Immediate Print Criteria This item is treated as a comment for current version Immediate Print Output Class Job Log SYSLOG Comment Job Class amp User Comment Dump Retention Period yx LBP Information This item is treated as a comment in current version Delete Retention Period A LOG User s Manual 11 49 Chapter 11 A LOG System Utilities 11 14 ALOGJRST Utility 11 14 1 Functional Overview ALOGJRST utility is used to restore job log indexes and or data from a Dump MT to A LOG Management Database and or A LOG Data Pool It can also be used to list the contents of a Dump MT However in one execution of the utility only one of these functions can be performed For restore function the job log s to be restored are selected based on Job Name Storage Date and Storage Time which are specified in the Restore parameter cards The user may choose to restore the job log index only the job log data only or both the job log index and data The Dump MT containing the job log s to be restored is dynamically allocated by ALOGJRST utility using the Dump MT information stored in the job log index If the index has been deleted the user must specify the Dump MT information in the DDIN DD statement of ALOGJRST utility JCL A li
158. he nucleus of A LOG System It performs the following functions e Job logs and SYSLOGs storage execution and monitoring e A LOG monitoring commands processing e A LOG database management Refer to Chapter 9 A LOG Monitoring Facility for further details A LOG Terminal Facility This facility is used for performing online inquiry print delete functions from a TSO or TSS terminal on the job logs or SYSLOGs stored in A LOG database Refer to Chapter 10 A LOG Terminal Operations for further details A LOG Security Protection Facility This facility uses the A BAS Security Management Facility to restrict the use of A LOG Terminal Facility by User IDs This facility sets security protection at job log or SYSLOG level It stores security protection definitions for each User ID in a Security Management Table Refer to A LOG System Administrator s Manual and A BAS Security Management User s Manual for further details A LOG User s Manual Chapter 1 A LOG System Facilities A LOG Master Management Facility A LOG Master Management Facility manages the following master files 1 Job Log Master Job log management information are defined in Job Log Master by the user When a job log is stored into A LOG database a job log index is created on the basis of the information defined in Job Log Master Job Log Master contains the following items e Job Log ID e Dump Retention Period e Valid Date e Delete Retention
159. ied DUMP DSNAME ee E A Dataset name of Dump MT is displayed VOL SER EEREN Volume serial number of Dump MT is displayed LABEL a S i Label number of Dump MT is displayed RESTORE REQUEST Condition of restore reservation is displayed A No request for restoration ON Reservation for restore has been set OFF Reservation for restore not set RESTORE STATUS Whether a restoration has been performed or not is displayed INDEX Index has been restored DATA Data has been restored INDEX DATA Both index and data have been restored If this item is blank Dump Retention Period and Delete Retention Period are valid Otherwise After Restore Data Retention Period and After Restore Index Retention Period will become valid after restoration This item shows the history of restoration Hence if the restored data is deleted storage location is returned to its original value of DUMP MT but this item remained unchanged estore pare Tre mat eoem romaane isapa RESTORED DATA 4 Numeric After Restore Data Retention Period is displayed RETENTION DAYS This item may be modified by specifying a value between 0000 to 1830 This value will also be updated by the execution of ALOGJRST or ALOGRSEL utility RESTORED INDEX 4 Numeric After Restore Index Retention Period is displayed RETENTION DAYS This item may be modified by specifying a value between 0000 to 1830 This value will also be updated by the execution of ALOGJRST or ALOGRSEL utility
160. index matching the specified selection criteria JBI IFLE FIND ERROR RSP resp code An error has occurred while finding job log index JBI FILE READ ERROR RSP resp code An error has occurred while reading job log index JBI STORE EXCEED MAX COUNT OF nnn Number of job log indexes have exceeded the maximum number allowed for the file INVALID FUNCTION An invalid function code has been specified A LOG DATE GET ERROR RSP resp code An error has occurred while obtaining A LOG operation date n n n CALLED SCREEN LOAD ERROR An error has occurred while loading screen module with menu number n n n INPUT COND CODE A job completion code must be specified INPUT JOB START DATE A job start date must be specified INPUT INDEXIDATA RETENTION DAYS Either a non numerical value has been specified for After Restore Index Retention Period or After Restore Data Retention Period or a value exceeding 1831 has been specified A LOG User s Manual 10 29 Chapter 10 A LOG Terminal Operations 2 1 1 1 Job Log Directory Screen A LOG 2 1 1 1 JOBLOG DIRECTORY INQ UPD 96 09 04 14 09 57 COMMAND gt OP MSG DATE JOB NAME JOB NO S DATE S TIME E TIME PAGE Q JOBLOG ID JOBLOG JOBLOG JOBLOG JOBLOG JOBLOG JOBLOG JOBLOG JOBLOG JOBLOG JOBLOG JOBLOGAE JOBLOGAE 960105 V380ALOG STC00345 960831 152605 152652 0003 960105 V380ALOG STC00352 960831 152724 154415 0003 960107 V380ALOG STCOO420 960831 155034 161129 0004 960107 V380ALO
161. ing column number of the data shown is displayed Starting column number of the data shown is displayed LINE NO etl eoi Starting line number of the data shown is displayed SYSLOG ID Ceo SYSLOG ID entered from previous screen is displayed SCH DATE Starting Ending operation date entered from previous screen is displayed SYSLOG TIME Starting Ending time entered from previous screen is displayed A LOG User s Manual Chapter 10 A LOG Terminal Operations Screen Operations Scrolling of SYSLOG Data Required Item Specification COMMAND Specify the appropriate command for scrolling the data Specify a valid command and press ENTER key Searching for Specific Character Strings Required Item Specification COMMAND Specify F string command Specify the above and press ENTER key The line containing the character string will be displayed Up to a maximum of 18 characters can be specified in the character string If the character string contains an embedded blank enclose the character string with quotes If the search is performed on data displayed in HEX format specify the character string in HEX format such as F1FO5BC140C2 To continue searching for the same character string specify FIND command and press ENTER key Display of SYSLOG Data in HEX Format Required Item Specification COMMAND Specify HEX command Specify the above and press ENTER key The SYSLOG data will be displayed
162. ion from A LOG Terminal Facility Reservation for restoration of SYSLOGs can be performed from A LOG Terminal Facility A REST ON command from A LOG Terminal Facility will set the Restore Reservation Flag to ON This command is applicable only to those SYSLOGs with DUMP MT as the current Storage Location Restoration of the SYSLOGs is performed only when ALOGRSEL utility is executed Refer to 7 5 4 ALOGRSEL Utility for further details Usage Procedure 1 On 3 2 1 SYSLOG Directory screen enter REST ON command after specifying R in the OP column of the SYSLOG s to be reserved for restore To cancel reservation for a restore enter REST OFF command after specifying R in the OP column of the SYSLOG s for which its reservation for restore is to be canceled A LOG 3 2 1 COMMAND gt REST ON SYSLOG DIRECTORY INQ UPD 96 09 04 14 19 29 OP SEQ R 001 LOG LOGID SCH DATE 960807 CATALOG START DATE TIME 960807 125520 CATALOG END DATE TIME 960807 145820 PLACE DUMP MT RSTR R 002 LOG 003 LOG 960809 004 LOG 960810 LOG 960811 LOG 960812 LOG 960813 LOG 960814 LOG 960815 END OF DATA 960808 960808 134559 960809 090354 960810 104636 960808 172459 960811 005401 960809 200814 960810 210436 960811 105211 960812 125124 960813 115149 960814 093951 960815 164441 DUMP MT DUMP MT BKS BKS 960812 024144 960813 003341
163. is shown on the following page A LOG User s Manual 11 59 Chapter 11 A LOG System Utilities Dump MT Proof List A LOG ADVANCED JOBLOG SYSLOG MANAGEMENT SYSTEM VERSION 03 80 BY BSP INC DATE 96 02 14 TIME 21 44 07 PROOF LIST OF DUMP BKS SYSLOG LIST CODE DMP100 S DSN SYSLOG D921026 NX MT LABEL 001 ES 9 o as CAT DATE CAT TIME JOB NAME ST M PAGE VOLSER 96 02 09 09 00 00 SYSI TC00001 1 96 02 09 END 10000 BSP216 96 02 10 09 00 08 SYSI TC00001 I 96 02 10 END 15867 BSP216 Dataset Name of Dump MT Storage Status Label Number of Dump MT A Not Yet Stored SYSLOG Storage Date END Storage Ended SYSLOG Storage Time ABEND Storage Abended Job Name Number of Dumped Pages Job Number Volume Serial Number of Dump MT SYSLOG ID x Delete Retention Period Expire Date A LOG User s Manual 11 60 Chapter 11 A LOG System Utilities 11 16 ALOGLLOG Utility 11 16 1 Functional Overview ALOGLLOG utility is used to generate a SYSLOG Index Release File and a SYSLOG Audit Trail List SYSLOGs to be output to the release file and audit trail list can be selected based on the SYSLOG Storage Date and Job Completion Code selection criteria specified in the EXEC parameters An option to print SYSOUT information to the audit trail listing is also provided 11 16 2 Processing Requirement EXEC Parameter A LOG Management Ss Database ALOGLLOG SYSLOG Index Utility
164. is used HOLIDAY gt Holiday Master Reference Option Y Holiday Master is referenced N Do not reference Holiday Master Default A LOG User s Manual 11 23 Chapter 11 A LOG System Utilities 11 10 2 ALOGDMP2 Utility 11 10 2 1 Functional Overview ALOGDMP2 utility reads the Job Log Index File Selected Job Logs created by ALOGDMP1 utility For each job log in the file it dumps the job log data to Dump MT if it is not a restored job log and then deletes the data from A LOG Management Database In order to retrieve the job log data from A LOG Data Pool ALOGDMP1 utility refers to the Job Log Data Index File created by ALOGDMP1 utility A list of the dumped job logs is output to the Job Log Dump Proof List A list of the deleted job log data is output to Job Log Data Deletion Proof List A LOG Monitor must be started before executing this utility If not the utility will display the message SSB101I ALOG IS NOT ACTIVE on the console every 10 seconds until A LOG Monitor is started 11 10 2 2 Processing Requirement 11 24 A LOG Management A LOG Data Pool Database Job Log Dat Job Job Log Index Index EXEC Parameter Job Log Data Lee ME MT Lee ME Job Log Index ALOGDMP2 Selected Job Utility Logs 4 Job Log Data Deletion Proof List Job Log Data Index Job Log Dump Proof List Fig 11 11 Processing Outline of ALOGDMP2 Utility The procedure for executing ALOGD
165. ity is still active Cancel ALOGSLOG utility using OS cancel command Then rerun ALOGSLOG utility If ALOGSLOG utility is requesting processing from A LOG Monitor while it has abended ALOGSLOG utility will display message SCT206E and end with RSP 148 If A LOG Monitor has abended after ALOGSLOG has requested processing from it ALOGSLOG utility will be left waiting for a reply from A LOG Monitor Actions by A LOG System The handling of job logs and SYSLOGs during rerun of ALOGJLOG and ALOGSLOG utilities is same as described in 9 6 1 Abend of ALOGJLOG Utility and 9 6 2 Abend of ALOGSLOG Utility A LOG User s Manual 9 6 4 System Down Actions by Users Restart A LOG Monitor after recovery from system down Restart ALOGJLOG utility Restart ALOGSLOG utility Actions by A LOG System Chapter 9 A LOG Monitoring Facility The handling of job logs and SYSLOGs during rerun of ALOGJLOG and ALOGSLOG utilities is same as described in 9 6 1 Abend of ALOGJLOG Utility and 9 6 2 Abend of ALOGSLOG Utility A LOG User s Manual Chapter 10 A LOG Terminal Operations 1 0 0 2 0 0 3 0 0 9 0 0 Job Log SYSLOG Job Log SYSLOG System Master Management Management Management Management 1 1 0 2 1 0 2 2 0 3 1 0 3 2 0 9 1 0 Job Log SYSLOG Job Log Index Dump MT SYSLOG SYSLOG Index Terminal PF Keys Master Maintenance Maintenance Inquiry Data Select
166. ity is used to restore SYSLOG indexes and or data from a Dump MT to A LOG Management Database and or A LOG Data Pool It can also be used to list the contents of a Dump MT However in one execution of the utility only one of these functions can be performed For restore function the SYSLOG s to be restored are selected based on job name SYSLOG ID Storage Date and Storage Time which are specified in Restore parameter cards The user may choose to restore SYSLOG index only SYSLOG data only or both the SYSLOG index and data The Dump MT containing the SYSLOG s to be restored is dynamically allocated by ALOGLRST utility using the Dump MT information stored in the SYSLOG index If the index has been deleted the Dump MT information must be specified in the DDIN DD statement of ALOGLRST utility JCL A list of the restored SYSLOGs is output to SYSLOG Restore Proof List Limitation All SYSLOGs to be restored together must have been dumped by the same run of the dump utility ALOGLDMP 11 17 2 Processing Requirement 11 64 A LOG Management Database Restore Parameters SYSLOG Index ALOGLRST g USMSLRST Guit Parameter ality a A LOG Data Pool we En SYSLOG Data SYSLOG Restore Dump MT Proof List Inquiry List Fig 11 20 Processing Outline of ALOGLRST Utility The procedure for executing ALOGLRST utility is as follows 1 Specify the Restore parameter cards in DDCNTL DD statement 2 Modify the USMSLRST parameter card
167. job logs or SYSLOGs matching specified conditions are deleted Generate Delete Proof List An output listing showing the deleted job log or SYSLOG indexes is generated A LOG User s Manual 7 33 Chapter 7 A LOG Retention Management Facility 7 7 4 ALOGDLT1 Utility ALOGDLT1 utility can be used to delete job log or SYSLOG data EXEC Parameter DDSCT gt ALOGDLT1 pre Utility A LOG Management Database A LOG Data Pool SYSPRINT Job Log SYSLOG Data Delete Proof List Fig 7 26 ALOGDLT1 Utility Processing Outline Refer to ALOGDLT1 Utility in Chapter 11 A LOG System Utilities for further details ALOGDLT1 utility offers the following functions Select Job Logs or SYSLOGs Specify in EXEC parameter which job log or SYSLOG data is to be deleted Select Deletion Targets For those job logs or SYSLOGs which are not restored the job log or SYSLOG data which have been dumped are deleted The Storage Location of the indexes are changed from BKS to DUMP MT For those job logs or SYSLOG which have been restored the job logs or SYSLOGs matching the following condition are deleted Generate Data Delete Proof List An output listing showing the deleted job log or SYSLOG is generated A LOG User s Manual Chapter 8 A LOG Audit Trail Management Facility A LOG Management Database Job Log Index Master SYSLOG Index Master Date Parameter pm Date Parameter
168. lays the usage rate of A LOG database The boundary and incremental values are specified in RUNSPM2 parameter For further details about RUNSPM2 parameter please refer to 6 2 Parameter Library of A LOG System Administrator s Manual Command Syntax F ALOG NUTL Example Operator enter F ALOG NUTL A LOG messages displayed on console SPM0111 OPERATOR TYPED IN NUTL SPM1231 NUTL 060 NUTI 005 ve Boundary value If the utilization rate exceeds 60 message SPMOO9A will be displayed automatically Increment value After the utilization rate has exceeded 60 message SPMOO9A will be displayed automatically for every 5 increase in the utilization rate A LOG User s Manual 9 13 Chapter 9 A LOG Monitoring Facility 9 6 9 6 1 Recovery Management Abend of ALOGJLOG Utility Actions by Users Determine the cause of error for the abend of ALOGJLOG utility by referring to A LOG Messages amp Codes Manual Rerun ALOGJLOG utility Actions by A LOG System When ALOGJLOG utility is rerun it resumes storage of the job log from the remaining SYSOUT dataset of the job log that was being stored when the utility abended The job log that is being stored at the time of abend is handled as follows JOBA Problem solved SOUTO001 y Re execution Store Abend 1 e gt SOUTOO02 EE en Start of storage of job log for JOBA Status in index Being stored Status in index Storage com
169. lity TSO TSS LLN A LOG Terminal Facility DDOUT DDSCT DDBKS SYSLOG Output Fig 11 23 Processing Outline of WIRSUTL The procedure for executing WTRSUTL utility is as follows 1 Specify the Print selection parameter cards 2 Modify the EXEC parameter as required 3 Modify the DDSPARM parameter card as required 4 Specify the Dump MT information if necessary and 5 Run WTRSUTL utility A LOG Management SYSLOG Index DDIN ae DDPARM A LOG Data Pool E AAA SYSLOG Data A LOG User s Manual 11 79 Chapter 11 A LOG System Utilities 11 20 3 Input Requirement 11 80 1 Print Selection Parameter Cards Specify the Print selection parameter in DDCNTL DD statement The Print selection parameter consists of a PRINT statement and a SELECT statement A PRINT statement is used to select the SYSLOG and the date and time range to print A SELECT statement is used for more selective printing as follows Print SYSLOG records of a specific job only Print only SYSLOG records that contain one or more specified strings Specify the start and end line numbers to print and Specify the maximum number of lines to print The SELECT statement is optional PRINT Statement Format PRINT SYS syslog id MAKED yymmdd MAKET yymmdd MKTMF hhmmss MKTMT hhmmss where SYS SYSLOG ID of the SYSLOG to be printed MAKED gt Start Date of SYSLOG to be printed MAKET gt End Date of SYS
170. lity enter XEXIT command on any screen and press the ENTER key The TSO TSS terminal will return to READY state To return to A SPOOL A LOG Select screen enter X for the SELECT item on 0 0 0 Initial Menu screen and press the ENTER key Refer to Fig 10 2 for further details A LOG User s Manual 10 9 Chapter 10 A LOG Terminal Operations 10 5 10 10 Job Log SYSLOG Master Management 1 0 0 Job Log SYSLOG Master Management Screen A LOG 1 0 0 JOB SYSLOG MASTER MANAGEMENT 96 09 04 14 04 12 COMMAND gt SELECT NUMBER gt 1 JOB SYSLOG MASTER MAINTENANCE Function This screen is displayed when 1 is specified in SELECT item of 0 0 0 Initial Menu screen It is the first of a series of screens for performing registration deletion modification and inquiry of Job Log Master or SYSLOG Master records Screen Operations From this screen you can proceed to 1 1 0 Job Log SYSLOG Master Maintenance screen as follows SELECT NUMBER Specify 1 Specify the above and press ENTER key If 1 1 0 Job Log SYSLOG Master Maintenance screen is protected and you do not have the authority to access to that screen control is returned to this screen after pressing the ENTER key A LOG User s Manual Chapter 10 A LOG Terminal Operations Flow of Job Log SYSLOG Master Management Screens The following figure shows the flow of job log SYSLOG master management screens Legend XXXX Comm
171. log to be printed is on a Dump MT and the unit name to be allocated to the Dump MT is not TAPE A LOG User s Manual 11 75 Chapter 11 A LOG System Utilities 4 Dump MT Information Specification The Dump MT information must be specified in DDIN DD statement if the following conditions are true e The job log data to be printed is on Dump MT e The UNIT keyword is not specified in the DDJPARM parameter card and e The unit name for the Dump MT is not TAPE 11 19 4 Sample Execution JCLs WTRIUTL STEPLIB STEPCAT SYSOUT USMSOUT DBSNAP SYSUDUMP DD DDSNAP DDKANJI SYSUT1 SORTLIB SORTIN SORTOUT SORTWKO1 DD SORTWKO2 DD SORTWKO3 DD DDPARM DDCNTL DD DD DD DD D D D D DD DD DD DD DD DSN ALOG V0380 LOAD DISP SHR DSN ALOG UCAT DISP SHR SOUT SOUT MMY SOUT DUMMY UNIT SYSDA SPACE TRK 1 1 VOL SER BSP001 DSN ALOG V0380 SCT DISP SHR DSN ALOG V0380 BKS DISP SHR SYSOUT DUMMY DYNALLOC MESSAGE EXEC PGM WTRJUTL PARM S 0000 REGION 512K DD DSN ALOG DMP D940210 DISP SHR UNIT TAPE DEFER DCB LRECL 133 BLKSIZE 1330 RECFM FBA DSN SYS1 SORTLIB DISP SHR UNIT SYSDA SPACE TRK 10 5 UNIT SYSDA SPACE TRK 10 5 UNIT SYSDA SPACE TRK 10 5 UNIT SYSDA SPACE TRK 10 5 UNIT SYSDA SPACE TRK 10 a DSN ASPOOL VO380 PARMLIB D PRINT JOB ASPASM MAKED 960213 11 19 5 Output Lis
172. low Dump Parameters EXEC Parameter A LOG Management Database OY ALOGDMP1 Utility Job Log Index Selected Job Logs Job Log Index All Job Logs ALOGDMP4 Data Index Utility EXEC Parameter ue ALOGDMP3 Utility A LOG Management Database A ALOGDMP2 Job Log Index Utility Nal MT Nal he ee ae Data Pool EXEC Parameter Job Log Index Deletion Proof Job Log Data Job Log Dump Deletion Proof Proof List Job Log Data List List Fig 11 9 Processing Outline of High Speed Dump amp Delete Utilities A LOG User s Manual 11 21 Chapter 11 A LOG System Utilities 11 10 1 ALOGDMP1 Utility 11 10 1 1 Functional Overview ALOGDMP1 utility copies the contents of A LOG Management Database to a sequential work file Using this file it creates the following three sequential files for use by ALOGDMP2 and ALOGDMP3 utilities Job Log Index File All Job Logs This file contains all job log indexes in A LOG Management Database Job Log Data Index File This file contains indexes to the data of all job logs in A LOG Management Database and Job Log Index File Selected Job Logs This file contains the indexes of job logs that are to be dumped and job logs with restored data that have exceeded the retention period The job logs to be dumped are selected based on the Dump parameter specifications These parameters are the same as
173. lphanumeric Specify the job name of the job log to be restored A maximum of 100 1 8 job names can be specified in one JOB keyword However all the job logs must have been dumped by the same run of the ALOGJDMP utility This item must be specified MAKED Numeric Specify the Storage Date of the job log to be restored in yymmdd 6 format MAKET Specify the Storage Time of the job log to be restored in hhmmss 6 format INDEX Alphabetic Specify the restore object 1 4 YES Restore job log data and index NO Restore job log data only default ONLY Restore job log index only KEEPD Numeric Specify the number of days between 0 1830 to retain the job log data 1 4 after restoration default is 0 KEEPI Numeric Specify the number of days between 0 1830 to retain the job log 1 4 index after restoration refer to Section 7 2 4 for default LIST Alphabetic Specify YES to list the contents of Dump MT in the Dump MT 3 Inquiry List tl The Job Name Storage Date and Storage Time of a job log can be obtained from the Job Log Index Directory screen A LOG screen 2 1 1 1 the Job Log Dump Proof List or the Dump MT Inquiry List 12 The LIST keyword is mutually exclusive with all other keywords In other words in one execution of ALOGJRST utility either restore or list but not both function can be requested A LOG User s Manual 11 51 Chapter 11 A LOG System Utilities Example To restore job logs SALEJ100
174. lt Storage has started e ABEND lt JStorage has abended e END lt x Storage has ended Storage location of the job log e blank lt X Not yet stored or already deleted e BKS lt X In A LOG database e DUMPMT amp lIn Dump MT Destination Code of the Job Log Master record For this version unless LOCAL is set in this field otherwise it will be filled up with blanks Job log comment of the Job Log Master record User comment of the Job Log Master record Dataset name of the Dump MT where job log data is stored Volume serial number of the Dump MT where job log data is stored Label number of the Dump MT where job log data is stored A Restore request status e blank amp lJob log data is in A LOG Data Pool e ON amp lRestore reservation is ON e OFF lt XRestore reservation is OFF Status of restoration e INDEX lt X Index has been restored e DATA lt X Data has been restored e INDEX DATA lt X Both index and data have been restored Most recent restore date The value of this item is 000000 when the job log is stored After job log is restored this value is set to the value specified in parameter of ALOGJRST or ALOGRSEL utility or the value specified in DATA RETN DAYS item of A LOG 2 1 0 Job Log Index Maintenance screen The value of this item is 000000 when the job log is stored After the job log is restored this value is set to the value specified in parameter of ALOGJRST or ALOGRSEL utility or th
175. ltiple cards of this type can be specified 2 EXEC Parameters ALOGJMST ERCHK 1 2 DUPCHK 1 2 where ERCHK gt Definition Card Error Check Specify the level of definition card error check as follows 1 Do not register the record if it contains error Default 2 Register the record even if it contains error DUPCHK gt Duplicate Master Record Check Specify the level of master record duplicate check as follows 1 An error if a master record with the same Job Log SYSLOG ID and Valid Date E already exists Default E 2 Ifan existing master record with the same Job Log SYSLOG ID and Valid Date is found delete the old record and register the new record 11 13 4 Output Listings Sample output listings of Master Definition Card Proof List Master File Maintenance Proof List and Master File Inquiry List are shown on the following pages 11 46 A LOG User s Manual Chapter 11 A LOG System Utilities Master Definition Card Proof List A LOG ADVANCED JOBLOG SYSLOG MANAGEMENT SYSTEM VERSION 03 80 BY BSP INC DATE 96 06 05 TIME 18 56 57 JOBLOG MASTER CONVERSION CHECK LIST LIST CODE JAMOO1 ERR CODE 4 1 4 2 4 3 4 4 4 5 4 6 4 7 4 8 JA0010JOBLOG01960601AA00070007LOCAL JA0011JOBLOGO1 MASTER JA0012 JA0013 JA0014 JA0020JOBLOG01960601AA00070007LOCAL JA0021JOBLOGO1 MASTER JA0022 JA0023 JA0024 JA0030JOBLOGO1960601AA00070007LOCAL JA0031JOBLOGO2 MASTER J
176. m is assumed by default If only job end time is specified job start time equals 00 00 a m is assumed by default This item is valid only when the job start date is specified WRITER NAME 1 8 Alphanumeric Specify JCL member name of the WTRJUTL utility to be submitted when a PRINT command is entered Default JCL member name is WTRJUTL Length A LOG User s Manual 10 27 Chapter 10 A LOG Terminal Operations 10 28 WRITER Alphabetic SUBMISSION selection BY JOB MEMBER 1 8 Alphanumeric NAME DATA RETN 4 Numeric DAYS INDEX RETN 4 Numeric DAYS Screen Operations Inquiry Update of a Job Log Indexes Specify one of the following print method for the PRINT command N Print more than one job in one submission of the writer Y Submit writer once for each job Specify JCL member name of the ALOGJRST utility to be submitted when a RESTORE command is entered Default JCL member name is ALOGJRST Specify After Restore Data Retention Period for the RESTORE command A value between 0000 to 1830 may be specified Specified value will be used to set the KEEPD keyword of ALOGJRST utility Default is 0000 Specify After Restore Index Retention Period for the RESTORE command A value between 0000 to 1830 may be specified Specified value will be used to set the KEEPI keyword of ALOGJRST utility For default value refer to 7 5 6 Default Values for After Restore Index Retention Period and After Rest
177. med accordingly b If there are multiple master records A list of those master records is displayed on 1 1 1 Job Log SYSLOG Master Directory screen Specify S in the OP column for any of the listed master records and press the ENTER key Contents of the selected master record will be displayed on 1 1 2 Job Log SYSLOG Master screen After changing the contents enter SAVE command and press ENTER key Registration of master record is performed accordingly A LOG User s Manual Chapter 10 A LOG Terminal Operations e If the Job Log Master or SYSLOG Master record with the specified job log or SYSLOG ID does not exist c In the case of Job Log Master record registration If only one default Job Log Master record Job Log ID JOBLOG is registered the operations is same as described in a If multiple default Job Log Master records are registered the operations is same as described in b If no default Job Log Master record has been registered 1 1 2 Job Log SYSLOG Master screen will be displayed with the contents of all items displayed as blanks d Inthe case of SYSLOG Master record registration There is no default SYSLOG Master record Therefore 1 1 2 Job Log SYSLOG Master screen will be displayed with the contents of all items displayed as blanks Registration of a Job Log Master or SYSLOG Master Record by Copying Required Item SELECT FUNCTION Specify A JOB SYSLOG ID Specify a job log or SYSLOG ID o
178. n It is used for the following operations e Inquiry of SYSLOG data e Printing of SYSLOG data Flow of SYSLOG Data Select Screens The following figure shows the flow of SYSLOG Data Select screens f 3 1 0 Legend SYSLOG ENTER Key Data Select XXXX Command SYSLOG Data Inquiry Fig 10 8 Screen Flow of SYSLOG Data Select Function 10 54 A LOG User s Manual Chapter 10 A LOG Terminal Operations Screen Commands MENU To switch to 0 0 0 Initial Menu screen XEXIT To terminate A LOG Terminal Facility Description EXIT To switch to 3 0 0 SYSLOG Management screen To switch to menu screen corresponding to the specified menu number Input Output Items tem enga SYSLOG ID Alphanumeric Specify the SYSLOG ID for all as a selection criterion for inquiry or printing of SYSLOGs This item must be specified for printing of SYSLOGs 1 5 JOB NUMBER Alphabetic Specify the job number as a selection criterion for inquiry Numeric or printing of SYSLOGs First digit of the job number is for specifying one of the following Job IDs J JOB S STC T TSU Following 5 digits are for specifying the job number FIND CHARACTER 64 Alphanumeric Specify a character string as a selection criterion for STRINGS printing SYSLOGs with specific character string See note 1 SCH DATE 6 each Numeric Specify an operation date in yymmdd format as a selection criterion for inquiry or printing of
179. n Period and Delete Retention Period is valid Otherwise After Restore Data Retention Period and After Restore Index Retention Period will become valid after restoration This item shows the history of restoration Hence if the restored data is deleted storage location is returned to its original value of DUMP MT but his item remained unchanged RESTORE DATE Lee tae Most recent restore date is displayed RESTORED DATA Numeric After Restore Data Retention Period is displayed This RETENTION DAYS item may be modified by specifying a value between 0000 to 1830 This value will also be updated by the execution of ALOGLRST or ALOGRSEL utility RESTORED INDEX Numeric After Restore Index Retention Period is displayed RETENTION DAYS This item may be modified by specifying a value between 0000 to 1830 This value will also be updated by the execution of ALOGLRST or ALOGRSEL utility 10 74 A LOG User s Manual Chapter 10 A LOG Terminal Operations Screen Operations Modify Attributes of a SYSLOG Index Required Item Specification COMMAND Specify SAVE command Specify the new values for the items to be changed and the above command and press ENTER key Attributes of the SYSLOG index will be changed accordingly Note Only those items with the gt sign can be changed Request Restoration of a SYSLOG Required Item Specification COMMAND Specify RESTORE command Specify the above and press ENTER key
180. n SYSOUT data of a specific class are transmitted into the OS Spool of a specific CPU the job logs of the jobs executed on each of the CPUs can be stored into the A LOG database of an A LOG System However usage of A LOG System functions such as inquiry and printing of job logs from an online terminal utility etc is limited only to the CPU in which the A LOG System is installed Multi CPU Computer System JESMAS Spool A LOG Database Fig 1 2 Multi CPU Job Log Management using JESMAS IBM Multi CPU Computer System Specific Class Spooling Fig 1 3 Multi CPU Job Log Management using SYSOUT Data Transmission Fujitsu A LOG User s Manual Chapter 1 A LOG System Facilities 1 3 2 Using Multi CPU Function of A LOG System When the multi CPU function of A LOG System is used job logs of jobs executed on each CPU can be stored into an A LOG database Inquiry and printing of job logs stored in other CPUs can also be performed from a terminal utility etc In order to use A LOG System functions such as job log storage inquiry from a terminal and print function on each CPU the A LOG System must be installed on each CPU Specific Class AA Esmas spoor 75 Specific Class A LOG Database Share DASD A LOG System is installed in CPU 1 and CPU 3 The A LOG database can be shared by both CPUs Although not shown in above example A LOG System can also be installed in CPU 2 and share access to
181. n Screen A LOG User s Manual Chapter 3 A LOG Job Log Storage Facility A LOG 2 1 2 2 JOBLOG INDEX NO 1 INQ UPD 96 11 04 14 15 36 COMMAND gt JOB NAME V380ALOG LOG DATE 960812 JOB NO STCO1482 JOBLOG ID JOBLOG DUMP DSNAME ALOG V0380 JDMP VOL SER ALOGO1 LABEL 0001 RESTORE REQUEST ON RESTORE STATUS RESTORE DATE RESTORED DATA RESTORED INDEX RETENTION DAYS RETENTION DAYS gt 0000 Fig 3 3 Job Log Attribute Information Screen JOBNAME Jobnameofthejoblos oo o LOGDATE ALOG operation date when the job log is stored job log index is created for the job log END TIME CPU time when job is ended COND CODE Highest completion code from among the completion codes of each job step Total number of lines of the job log RETENTION DAYS Dump Retention Period of the Job Log Master record DUMP ELETE RETENTION Delete Retention Period of the Job Log Master record DAYS DELETE CPU time when storage of the job log is started ie A LOG User s Manual 3 3 PAGE COUNT Total number of pages of the job log EE A Chapter 3 A LOG Job Log Storage Facility END TIME STATUS CATLG STATUS PLACE DESTINATION CODE JOBLOG COMMENT USER COMMENT DUMP DSNAME VOL SER LABEL RESTORE REQUEST RESTORE STATUS RESTORE DATE RESTORED DATA RETENTION DAYS RESTORED INDEX RETENTION DAYS CPU time when storage of the job log is ended Storage status of the job log e START
182. n mgs Js Jeon f o Poor rosso ono feos ff mn nn fenton soe ness PARA E A LA O O E IB PO E A JO Joe om Poor ou vos fuses oo f aan Soerat coom 7 pio eof por Po fon sours E PEE A LOG User s Manual 3 17 Chapter 3 A LOG Job Log Storage Facility DDCATJ Parameter EXIT CATUJLOG SYSUT1 YES NO Specify whether or not to output a job log record for each job to the SYSUT1 DD statement by DDCAT DD statement of an execution procedure If a job log storage exit routine is used the job log record of SYSUT1 DD statement can be read EXT CATJLOG is fixed e YES lt X Output a job log record This is the default e NO lt X Do not output a job log record Job Log Storage Exit Routine Module Name EXIT job log exit routine module name If a job log storage exit routine is to be used specify the module name of the job log storage exit routine A value up to a maximum of 8 alphanumeric characters may be specified by DDJEXT DD statement of an execution procedure If not specify DUMMY JCL Analysis Exit Routine Module Name EXIT jcl modification exit routine module name If a JCL modification exit routine is to be used when submitting the print utility from the job log storage exit routine specify the module name of the JCL modification exit routine A value up to a maximum of 8 alphanumeric characters may be specified by DDJUTL DD statement of the execution procedure If not specify DUMMY JCL Libra
183. n one Restoration Job Name lt gt Job Number x Job Log SYSLOG ID Job Start Date Job Log SYSLOG Storage Date A LOG User s Manual 11 72 Chapter 11 A LOG System Utilities 11 19 WTRJUTL Utility 11 19 1 Functional Overview WTRJUTL utility is used to print job logs Options are available to e Print the entire job log e Printa dataset in the job log e Print a range of pages of a dataset in the job log and e Print Job Start Job End and SYSOUT Start separators Print Selection Parameter 11 19 2 Processing Requirement OZ e WIRJUIL Utility TSO TSS Sa A LOG Terminal Facility DDOUT Job Log Output DDJPARM Parameter DDIN DDCNTL DDPARM a Job Log Index a Data Pool A Ae DDSCT DDBKS A LOG Management Database Job Log Data Fig 11 22 Processing Outline of WTRJUTL The procedure for executing WTRJUTL utility is as follows 1 Specify the Print Selection parameter cards 2 Modify the EXEC parameter as required 3 Modify the DDJPARM parameter card as required 4 Specify the Dump MT information in the JCL if necessary and 5 Run WTRJUTL utility A LOG User s Manual 11 73 Chapter 11 A LOG System Utilities 11 19 3 Input Requirement 11 74 1 Print Selection Parameter Cards Specify the Print Selection parameter in DDCNTL DD statement The Print Selection parameter consists of a PRINT statement and a SELECT statement A PRINT statement is us
184. nce Holiday Master Default 11 10 3 4 Output Listing Refer to ALOGDLTS utility for an example of the Job Log Index Deletion Proof List A LOG User s Manual 11 27 Chapter 11 A LOG System Utilities 11 10 4 ALOGDMP4 Utility 11 10 4 1 Functional Overview ALOGDMP4 utility is used to delete the following three files created by ALOGDMP1 utility e Job Log Index File All Job Logs e Job Log Index File Selected Job Logs and e Job Log Data Index File 11 10 4 2 Processing Requirement ALOGDMP4 Utility Job Log Index Selected Job Job Log Job Log Index Data Index All Job Logs Logs Fig 11 13 Processing Outline of ALOGDMP4 Utility The procedure for executing ALOGDMP4 utility is as follows 1 If the dataset name of the files are changed in ALOGDMP1 utility modify the dataset names in ALOGDMP4 utility accordingly and 2 Run ALOGDMP4 utility 11 28 A LOG User s Manual Chapter 11 A LOG System Utilities 11 11 ALOGHOLT Utility 11 11 1 Functional Overview ALOGHOLT utility is used to perform batch maintenance and inquiry of Holiday Master file The maintenance functions provided are registration deletion and update of Holiday Master information The result of maintenance functions are output to the Holiday Master Maintenance Proof List For inquiry function the selected Holiday Master information are output to the Holiday Master Inquiry List in both Card format and Calendar format 11 11 2
185. nds Deseription MENU To switch to 0 0 0 Initial Menu screen EXIT To switch to 3 0 0 SYSLOG Management screen XEXIT To terminate A LOG Terminal Facility menu number To switch to menu screen corresponding to the specified menu number Input Output Items Hem Length SELECT 1 Alphabetic FUNCTION Specify one of the following function codes A Inquiry or Modification D Deletion SYSLOG ID Alphanumeric Specify SYSLOG ID as a selection criterion for generation of SYSLOG index a KE kal MEMBER NAME Alphanumeric o INDEX RETN 4 Numeric DAYS A LOG User s Manual Specify operation date of SYSLOG in yymmdd format as a selection criterion Specify ending date on the right column when using a range Specify JCL member name of ALOGLRST utility to be submitted for RESTORE command Default is ALOGLRST Specify a value between 0000 to 1830 as the After Restore Data Retention Period for RESTORE command Specified value will be used to set the KEEPD keyword of restore parameter of ALOGLRST utility Default is 0000 Specify a value between 0000 to 1830 as the After Restore Index Retention Period for RESTORE command Specified value will be used to set the KEEPI keyword of restore parameter of ALOGLRST utility For default value refer to 7 5 6 Default Values for After Restore Index Retention Period and After Restore Data Retention Period Chapter 10 A LOG Terminal Operations Screen Op
186. nition card for IBM MVS ESA os stu ah AS A A eee ie A PE PEE LJJOBLOG 015006PS0002 SSSODSN LIJCLLST 015006PS0003 SSSODSN LSSYSMSG 015006PS0004 SSSODSN LJJOBST 021008 HASP373 002008HH MM SS LJJOBET 021008 HASP395 002008HH MM SS JIJCLER 0210071EF4521 LJFAILED 0210071EF4531 LJCANCEL 0210071EF2511 LSJOBSD 0020071EF3751 008 START 005YYDDD LSJOBED 0020071EF3761 008 STOP OO5YYDDD LSCOND 0020071EF1421 0O10COND CODE 004NNNN LSSABEND 0020071EF4721 007SYSTEM 003NNN LSUABEND 0020071EF4721 005USER 004NNNN LOSYSOUT 019004 SSODSN A sample job log messages is shown on the following page Layout of the Job Log Message Definition card for IBM FUJITSU and HITACHI are shown on the following pages A LOG User s Manual 3 13 Chapter 3 A LOG Job Log Storage Facility Job Log Message Sample JES2 JOB LOG SYSTEM ESSAI 02 06 JOB00614 S HASP373 D53YCOPY STARTED INIT N3 CLASS A SYS ESA1 02 07 JOB00614 IEF403I D53YCOPY STARTED TIME 13 02 07 03 10 JOB00614 IEF404I D53YCOPY ENDED TIME 13 03 10 03 10 JOB00614 S HASP395 D53YCOPY ENDED Job Log DSN JES2 JOB00614 P0000002 D53YCOPY JOB D53Y CLASS A MSGCLASS C JOBCAT DD DSN ADACAT DISP SHR TEBCOPY EXEC PGM IEBCOPY REGION 512K INP DD DSN SDB2 D53Y LOAD DISP SHR 0U0 DD DSN SDB2 ADACSH LOAD DISP SHR JCL List DSN JES2 J0B00614 P0000003 kkk kkk SYSPRINT DD SYSOUT SYSIN D F236I ALLOC FOR D53YCOPY IEBCOPY F2371 8E0 ALLOCATED TO
187. nn 9 14 Fig 9 3 Handling of SYSLOG at Time of Abend o on 9 15 Fig 10 1 Screen Organization ocoooccocconconccnonncnccnncnncnnonnonncnncncnnnnnnco 10 1 Fig 10 2 Screen Flow of A LOG Terminal Facility oooococcccocccnccnccncncs 10 7 Fig 10 3 Screen Flow of Job Log SYSLOG Master Management Function 10 11 Fig 10 4 Screen Flow of Master Maintenance Operations 008 10 13 Fig 10 5 Screen Flow of Job Log Management Function ooooocccccnccnccnnon 10 24 Fig 10 6 Screen Flow of Job Log Index Maintenance Function 10 26 Fig 10 7 Screen Flow of SYSLOG Management Function ooooccccccncccncnos 10 53 Fig 10 8 Screen Flow of SYSLOG Data Select Function 0oooooccoccnccccnnnooo 10 54 A LOG User s Manual Table of Contents List of Figures Fig 10 9 Screen Flow of SYSLOG Index Maintenance Function 10 63 Fig 10 10 Screen Flow of System Management Function 085 10 78 Fig 11 1 Processing Outline of ALOGBLOG Utility oooooocccccccccccncccn 11 2 Fig 11 2 Processing Outline of ALOGCHKA Utility ee 11 5 Fig 11 3 Processing Outline of ALOGCHKL Utility 0 ee 11 6 Fig 11 4 Processing Outline of ALOGDATE Utility 0 ee 11 7 Fig 11 5 Processing Outline of ALOGDLT1 Utility oooo ococcnccncccncnnn 11 8 Fig 11 6 Processing Outline of ALOGDLT4 Utility 0 ee 11 10 Fig 11 7 Processing Outlin
188. nnnncnnncnn oo eaeenaeenaeees 7 32 A LOG User s Manual i Table of Contents Chapter 8 A LOG Audit Trail Management Facility 8 1 Audit Trail Management 0 eee ceseceneceneceseceseeeeneee e seneeeneeeneeeneeeaaeenaees 8 1 Chapter 9 A LOG Monitoring Facility 9 1 A LOG Monitoring Functions 000 eee ceseceseceneceeeceseeeeeeeseeseaeeeaeeeaeeenaes 9 1 9 2 Operation Dit cami da 9 2 9 3 Caution for Entering Date 0 0 ee eee ceeceeeceeeeeeeeeeeeeeseeeeecnaeee seneeeseeeseeees 9 3 9 4 Starting Terminating A LOG Monitor ccocococcconcconnconnnonnnonn nina nono es eaeenaeenseeees 9 4 9 5 A LOG Monitor Commands coocococccnoncnnnnnnnnnnnnonnnonnnonnncnnnonnncnnnanonen o cesseeseneeees 9 6 9 6 Recovery Management cccecccesssecesseceeceeceeeeeeaeceeaeeceeeeecsueeeee a cuaeeeeeeees 9 14 Chapter 10 A LOG Terminal Operations 10 1 Screen Organization enonse keneen e e ea atei ee rer Ae s 10 1 10 2 Key Functions seniii n n R cet lo R eee oes 10 2 10 3 Oyerview OF SCLECDS sceo irei Beebe en dela eS 10 4 10 4 Starting Ending a Session nenene E e E AR 10 7 10 5 Job Log SYSLOG Master Management sseeeeeeeeeeseeeseeerssreerresserrrreserns 10 10 10 6 Job Log Management 0 00 ee eecescceseeeeeeeseeeseeceecaecaeceaecnsecesaeaeseseeeenees 10 23 10 7 SYSLOG Management Terminal Operations 0 0 0 0 ee eeeeeeeeenee ee eeeeeneees 10 52 10 8 System Management Terminal Operations ooooocnncccnoncccnonacinnncnnnon ee ceeeeeeeees 10 77
189. ns e Registration of a Job Log Master or SYSLOG Master record e Updating of a Job Log Master or SYSLOG Master record Screen Commands MENU To switch to 0 0 0 Initial Menu screen XEXIT To terminate A LOG Terminal Facility To switch to 1 1 0 Job Log SYSLOG Master Maintenance screen during registration Otherwise to switch to 1 1 1 Job Log SYSLOG Master Directory screen SAVE To register or update job log or SYSLOG master record EMSG To switch to Error Message screen 10 20 A LOG User s Manual Chapter 10 A LOG Terminal Operations Input Output Items ee ar ja 1 ossos MSC raa O vana TO vanessa O RETENTION DAYS 4 Numeric Specify Dump Retention Period for the jog log or DUMP SYSLOG data RETENTION DAYS 4 Numeric Specify Delete Retention Period for the jog log or DELETE SYSLOG index DESTINATION CODE Alphanumeric Specify destination code for the job log or SYSLOG This item is treated as a comment in this version JOB SYSLOG Alphanumeric Specify job log or SYSLOG comment COMMENT USER COMMENT O Alphanumeric Specify user comment user comment LBP INFO MES Alphanumeric Specify LBP information Screen Operations Registration of a Job Log Master or SYSLOG Master Record Required Item Specification COMMAND Specify SAVE command Specify contents of the master record to be registered for each item specify the above and press ENTER key The master record will be registe
190. ntion Management Facility 7 4 6 Copying of Dump MT When a backup copy of a Dump MT is needed ALOGDMPC utility can be used to copy a Dump MT into another magnetic tape Refer to ALOGDMPC utility in Chapter 11 A LOG System Utilities for further details The following volume information regarding the target copy is written into the job log SYSLOG index on the Dump MT Target Copy e Volume serial number e Volume label e Write block point When restoring data from Target Copy delete the index in A LOG Management Database and restore both index and data from Target Copy since the volume information concerning the Source Copy is contained in the index of A LOG Management Database Index VOL SER BSP100 Data ALOGDMPC Utility Index VOL SER BSP200 High Speed Dump Delete Utilit BSP100 A LOG A LOG Management Database Data Pool Index NI CA ete gusts ate in tee se anes a cea ee Data During restoration delete index inside A LOG Management Database restore both index and data from Target Copy BSP200 Fig 7 10 ALOGDMPC Utility Processing Outline A LOG User s Manual 7 15 Chapter 7 A LOG Retention Management Facility 7 5 7 5 1 Restore of Job Logs Introduction Job logs which have been dumped by ALOGJDMP utility or fast dump delete utilities can be restored back into A LOG Management Database and A LOG Data Pool There are three 3 methods for rest
191. ntion Period Expire Date Legend The circled number indicates the number of working days the SYSLOG has been retained after that date e g for SYSLOG A after 11 May the SYSLOG has been retained for 2 days The 13 and 14 are holidays and hence not counted as retention days dotted line in diagram However for SYSLOG B the 13 is counted as one retention day because the SYSLOG was stored on that day Note When the Processing Date is on or before 31 December 1999 Holiday Master for A AUTO Version 5 2 0 or later can be used However if the Processing Date is on or after 1 January 2000 Holiday Master for A AUTO Version 6 0 or later must be used A LOG User s Manual 11 55 Chapter 11 A LOG System Utilities 2 The SYSLOGs to be dumped can be selected based on one or more of the following criteria specified in Dump parameter cards e Job name e Job number e Remaining retention days This is the number of days remaining before the retention period is exceeded and or e Keep days This is the number of days a SYSLOG should be kept in A LOG Data Pool after storage 3 The maximum number of pages of SYSLOG data to be dumped can be specified ALOGLDMP utility will terminate when the total number of pages of SYSLOG data dumped reaches the maximum number When ALOGLDMP utility completed normally the data of dumped SYSLOGs are deleted from A LOG Data Pool A Dump MT Information recor
192. nts storage of job logs or SYSLOGs and print processing from functioning until a new Operation Date is set by a DATE command or ALOGDATE utility This option is normally chosen for one of the following cases At the time of the first initiation of A LOG Monitor after installation of A LOG System When a new Operation Date is required To start A LOG Monitor with TYPE WARM option S ALOG JEM1001 ALOG ON STCINRDR JEM3731 ALOG STARTED SPM202I CURRENT DATE SET TO 96 06 01 SPM2001 START UP DATE PROCESSOR SPM2011 FINISH DATE PROCESSOR SPM2011 ALOG IS ACTIVE To start A LOG Monitor with TYPE COLD option S ALOG TYPE COLD JEM100I ALOG ON STCINRDR JEM373I ALOG STARTED SPM0031 COLD START OPTION ASSIGNED SPM004A ALOG WAITING FOR DATE COMMAND SPMOO1I ALOG IS ACTIVE A LOG User s Manual Chapter 9 A LOG Monitoring Facility 9 4 2 Terminating A LOG Monitor Methods There are two 2 ways to terminate A LOG Monitor properly Enter one of the following commands from a console P ALOG F ALOG CLOSE The above commands perform the same processing If A LOG Terminal Facility or an A LOG utility is still active at the time the command is entered A LOG Monitor does not stop immediately A LOG Monitor will terminate only after the A LOG Terminal Facility and or the A LOG utility have ended completely A LOG Monitor can be forced to terminate immediately even if A LOG Terminal Facility or
193. o nonn nono serere seerne 2 1 2 2 ALOGIMST Utility aiii iia 2 6 Chapter 3 A LOG Job Log Storage Facility IL AMtrOdUCtiON ca diia E EA EA dad Vangie 3 1 3 2 Job Log Indexadas 3 2 3 3 Job Log Data inci id 3 6 34 A LOGILOG Uli AAA ii 3 7 Chapter 4 A LOG SYSLOG Storage Facility 4 1 IO UCI a asias 4 1 42 SY SLOG Md a a a a ade IT 4 2 A3 SYSLOG Data se isin eel a E R die teea res nice kate A 4 5 4 4 A LOGSLOG Utilice rana 4 6 Chapter 5 A LOG Job Log Print Facility 5 1 WIMEPOGU CH A O RS 5 1 iZ dmmediate Print sc A A AA iain Meant 5 2 5 3 Print From A LOG Terminal Facility oooonnnnnnninnccnoncccnonnnonanacnnnnanannno cronos 5 3 34 WIRJUTE Utility cetoitoiacitiidepicccdbl canes haacebeiccche seanaces san EE ed iva abides 5 6 Chapter 6 A LOG SYSLOG Print Facility Ol INTO UCA A A DA A E T 6 1 6 2 Print From A LOG Terminal Facility ooononncnnnncnocononnconnconnconncnnnnno o saaeenaees 6 2 6 3 WIRSU TE Utility ccoo iio sages sas Eeee a ee daai ia 6 3 Chapter 7 A LOG Retention Management Facility Pek IM CO la ic aa 7 1 T2 Retention Pernod sik aise nid abel ile catia 7 3 7 3 Calendar Date amp Operation Date ooooconoccnococoncconnconnconnconnnnnncnna nono nonn cnn ee enaees 7 7 7 4 Dumping of Job Logs or SYSLOGS cccoccnccccoccnoccnonnnannnnnnonononnncnnncnnncnnoncnnnnos 7 8 TS Restore of Jog LOgs uti tia 7 16 7 6 Restore 08 SYSLOGS a AA ia do 7 25 7 7 Deletion of Job Logs or SYSLOGS cccoconoccconcconnconnnnnnnnnnn
194. ob Log Management using SYSOUT Data Transmission Fujitsu ooooococccncccnnccnnoncconnccnnccnncnnncnnacnnacnnos 1 6 Fig 1 4 Multi CPU Job Log Management using JESMAS IBM 1 7 Fig 1 5 Multi CPU Job Log Management using Multiple OS Spools 1 8 Fig 2 1 A LOG Master Management Functions cece eee ee eee ones 2 1 Fig 2 2 Job Log Master Registration ce cece eee ee eee eseeneneeeeeeeeenes 2 2 Fig 2 3 SYSLOG Master Registration cc ceee eee eeeenene ence ne eneeeeens 2 4 Fig 2 4 ALOGJMST Utility Processing Outline o n 2 6 Fig 3 1 A LOG Job Log Storage Facility 2 0 0 0 cece cece cece eee ne en eene teens 3 1 Fig 3 2 Job Log Attribute Information Screen cece se eee eee eee eee ee 3 2 Fig 3 3 Job Log Attribute Information Screen cece ee eee eee eee eee en 3 3 Fig 3 4 SYSOUT Attribute Information Screen ooooocccccoccnccnconccnccnconons 3 5 Fig 3 5 ALOGJLOG Utility Processing Outline cece eeren 3 8 Fig 4 1 A LOG SYSLOG Storage Facility oooocoococcconccnconconccccnncncnnnns 4 1 Fig 4 2 SYSLOG Index Screen aeiio ea eE E EE ETE EEE Tiea 4 2 Fig 4 3 SYSLOG Index Screen 0 cece sir n anii nin ieee 4 3 Fig 4 4 ALOGSLOG Utility Processing Outline ooooooccccccccnccncnnccnns 4 6 Fig 5 1 A LOG Job Log Print Facility 0 0 0 0 cece eee ec ene eeeeee enon es 5 1 Fig 5 2 If N specified
195. od and e Delete the index and data of job logs that have exceeded the retention period Although the above functions can also be performed by ALOGJDMP and ALOGDLTS utilities these utilities impose a performance penalty on online users of A LOG Terminal Facility The functions of each High Speed Dump amp Delete utility are described below ALOGDMP1 Utility This utility copies the contents of A LOG Management Database to a sequential work file Using this file it creates three sequential files for use by ALOGDMP2 and ALOGDMP3 utilities The first file contains all job log indexes The second file contains the indexes to all job log data The third file contains job log indexes of job logs that are to be dumped and job logs with restored data that have exceeded the retention period ALOGDMP2 Utility This utility dumps job log data and deletes them from A LOG Data Pool It also deletes restored job log data that have exceeded the retention period This utility requires the sequential files created by ALOGDMP1 utility ALOGDMP3 Utility This utility deletes job log indexes from A LOG Management Database and data from A LOG Data Pool It requires the sequential files created by ALOGDMP1 utility 9 ALOGDMP4 Utility This utility deletes the three sequential files created by ALOGDMP1 utility A LOG User s Manual Chapter 11 A LOG System Utilities The processing outline for the High Speed Dump amp Delete utilities is shown be
196. of the Job Log Queue A LOG User s Manual 9 11 Chapter 9 A LOG Monitoring Facility 9 5 7 NCQE NMAQ NMQE NPQH NUSQ Commands Function To display the total numbers of entries and current numbers of entries in use in CQE MAQ MQE PQH and USQ internal tables in A LOG Monitor The total numbers of entries are specified in NCQE NMAQ NMQE NPQH and NUSQ keywords of RUNSPM2 parameter For further details about RUNSPM2 parameter please refer to 6 2 Parameter Library of A LOG System Administrator s Manual Command Syntax F ALOG NCQE NMAQ NMQE NPQH NUSQ Example Operator enter F ALOG NMAQ A LOG messages displayed on console SPM0111 OPERATOR TYPED IN NMAQ SPM1211 NMAQ 020 001 NMQE 020 000 NCQE 020 000 x NUSQ 020 000 NPQH 025 017 ve Total number of entries and number of entries currently in use in MAQ internal table Total number of entries and number of entries currently in use in MQE internal table Total number of entries and number of entries currently in use in MCQE internal table Total number of entries and number of entries currently in use in NUSQ internal table Total number of entries and number of entries currently in use in NPQH internal table A LOG User s Manual Chapter 9 A LOG Monitoring Facility 9 5 8 NUTL Command Function To display the boundary and increment values for automatic display of message SPMOO9A Message SPMOO9A disp
197. og logs to be deleted COMMAND Specify DELETE command Specify the above and press ENTER key Before performing these instructions you must have specified D in for the SELECT FUNCTION item in 2 1 0 Job Log Index Maintenance screen Request Restoration of Job Logs Required Item Specification OP Specify R for the jog logs to be restored COMMAND Specify RESTORE command Specify the above and press ENTER key ALOGJRST utility will be submitted for restoration of the job logs The member name specified in MEMBER NAME field of 2 1 0 Job Log Index Maintenance screen is used for submission Upon successful submission of ALOGJRST utility the message RST will be displayed in the MSG column of the job logs Notes 1 Only when the Storage Place of the job log data is in Dump MT the job log can be restored 2 If the dataset name label and first volume serial number of the Dump MT of all the selected job logs are the same up to a maximum of 100 job logs can be restored Reserve Restoration of Job Logs Required Item Specification OP Specify R for the jog logs to be reserved for restoration COMMAND Specify REST ON command Specify the above and press ENTER key The Restore Reservation Flag for the job log will be set to ON Actual restoration of the job log is performed only when ALOGRSEL utility is executed Note Only when the Storage Place of the job log data is in Dump MT the job log
198. ollows HOLTABLE DD DSN holiday master dataset name member name DISP SHR A LOG User s Manual 11 39 Chapter 11 A LOG System Utilities 3 EXEC Parameters ALOGJDMP DMPVOL volser PDATE yymmdd HOLIDAY Y N where DMPVOL gt Dump MT Volume Serial Number Specify the volume serial number of the Dump MT To change the dataset name of the Dump MT modify DDOUT DD statement of the JCL PDATE gt Processing Date Specify the processing date in yymmdd format If omitted the current A LOG Operation Date is used HOLIDAY Holiday Master Reference Option Y Holiday Master is referenced N Do not reference Holiday Master Default 11 12 4 Output Listing A sample output listing of Dump MT Proof List is shown on the following page 11 40 A LOG User s Manual Chapter 11 A LOG System Utilities Job Log Dump Proof List A LOG ADVANCED JOBLOG SYSLOG MANAGEMENT SYSTEM VERSION 03 80 BY BSP INC DATE 96 02 14 TIME 21 44 07 PROOF LIST OF DUMP BKS JOBLOG LIST CODE DMP100 J DSN ALOG D921026 NX MT LABEI kd E 9 o CAT DATE CAT TIME JOB NAME JOB NO S DATE P DATE VOLSER JOBLOG ID 96 02 10 16 19 59 ZZKCS4T JOB02182 96 02 10 s 96 02 10 BSP216 L100101 96 02 10 17 38 00 ZZKCS4T JOB02441 96 02 10 96 02 10 BSP216 L100101 96 02 10 17 36 54 ZZKCS4T JOB02544 96 02 10 96 02 10 BSP216 L100101 96 02 10 17 59 36 ZZKCS5B JOB02654 96 02 10 H 96 02 10 BSP216 L100202 96 0
199. on screen provided by A LOG Terminal Facility Chapter 11 describes A LOG system utilities It explains the functions processing requirements input requirements and output listings generated by each A LOG system utility The following manuals may be referenced together with this manual when using A LOG system 1 A LOG System Administrator s Manual 2 A LOG Messages amp Codes Manual Readers comments and suggestions are welcome A Suggestion Page is provided at the back of this manual Please duplicate and use this page for sending your comments and suggestions to BSP A LOG User s Manual Chapter 1 A LOG System Facilities OS Spool A LOG Master Management Facility Job Log Master A LOG Job Log SYSLOG Storage Facility ey SLOG Maas A LOG Retention Management Facility zx A LOG Database A LOG Management Database lt gt A LOG Monitoring Facility A LOG Data Pool o o ALLG Job Log SYSLOG A LOG Terminal Facility Print Facility BO A LOG Audit Trail Management Facility lt A LOG Security Protection Facility LLEN Chapter 1 A LOG System Facilities 1 1 Components of A LOG System A LOG Advanced Job Log amp SYSLOG Management System is an automated operation system designed for reducing costs and improving productivity and reliability of computer operations It simplifies job management and enables effective use of computer resou
200. onship with A LOG Monitor A LOG A LOG A LOG Utility Monitor Utility Monitor Utility Monitor ALOGBLOG ALOGDMPC ALOGJMST ALOGCHKA ALOGDMP1 ALOGJRST ALOGCHKL ALOGDMP2 ALOGLDMP ALOGDLT1 ALOGDLT4 ALOGHOLT ALOGDLT5 ALOGJDMP A LOG Monitor must be active A LOG Monitor must be inactive Independent of A LOG Monitor ALOGDMP4 ALOGRSEL WTRJUTL WTRSUTL ALOGDATE atocpmps E farooresr E Legend A LOG User s Manual 11 1 Chapter 11 A LOG System Utilities 11 2 ALOGBLOG Utility 11 2 1 Functional Overview ALOGBLOG utility is used to generate a Job Log Index Release File and a Job Log Audit Trail List Job logs to be output to the release file and audit trail list can be selected based on the job log Storage Date and Job Completion Code selection criteria specified in the EXEC parameters An option is also provided to print SYSOUT information to the audit trail listing 11 2 2 Processing Requirement EXEC Parameter A LOG Management Database ALOGBLOG lt Job Log Index Utility NX DDBLOG of STEP0010 7 DDPRINT of STEP0030 N Job Log Audit Job Log Trail List Index Release File Fig 11 1 Processing Outline of ALOGBLOG Utility The procedure for executing ALOGBLOG utility is as follows 1 Modify dataset name volume seri
201. ore Data Retention Period Specify the selection criteria if any and press ENTER key 2 1 1 1 Job Log Directory screen will be displayed with a list of selected job log indexes for inquiry update of job logs Deletion of a Job Logs Required Item Specification SELECT FUNCTION Specify D Specify the above and selection criteria if any and press ENTER key 2 1 1 1 Job Log Directory screen will be displayed with a list of selected job log indexes for deleting of job logs A LOG User s Manual Chapter 10 A LOG Terminal Operations Printing of Job Logs Required Item Specification WRITER NAME Specify JCL member name of WTRJUTL utility WRITER SUBMISSION BY JOB Specify print method for PRINT command Specify the selection criteria if any and press ENTER key 2 1 1 1 Job Log Directory screen will be displayed with a list of selected job log indexes for printing of job logs Restoration of Job Logs Specify the selection criteria and RESTORE JOB CONTROL items if any and press ENTER key 2 1 1 1 Job Log Directory screen will be displayed with a list of selected job log indexes for restoration of job logs Screen Messages INVALID MENU NO An invalid menu number has been specified CALLED SCREEN NOT FOUND The function associated with the specified menu number is not available INVALID SELECT KEY An invalid selection criterion has been specified RECORD NOT FOUND Unable to find job log
202. ore Index Retention Period lt Processing Date If the retention period is 29 or less and reference to Holiday Master is specified in EXEC parameter the retention period is calculated using working days only However if the job log is stored restored on a holiday that day is counted as one retention day The following example shows the calculation of retention periods using working days for job logs A to D C roay a A Delete Retention Period 5 days Delete Retention Period 5 days C After Restore Index Retention Period 1 After Restore Index Retention Period 1 Legend Storage Date E Restore Date E Delete Date A LOG User s Manual 11 13 Chapter 11 A LOG System Utilities The circled number indicates the number of working days that the job log or SYSLOG has been retained after that date e g for job log A after 11 May the job log has been retained for 2 working days The 13 and 14 are holidays and hence not counted as retention days dotted line in diagram However for job logs B and D the 13 is counted as one retention day because the job logs were stored restored on that day Note If the Processing Date is on or before 31 December 1999 Holiday Master for A AUTO Version 5 2 0 or later can be used However if the Processing Date is on or after 1 January 2000 Holiday Master for A AUTO Version 6 0 or later must be used 11 8 2 Processing Requirement 11 14
203. ored e INDEX DATA lt X Both index and data have been restored RESTORED DATA RETENTION DAYS RESTORED INDEX RETENTION DAYS The value of this item is 000000 when the SYSLOG is stored After SYSLOG is restored this value is set to the value specified in parameter of ALOGJRST or ALOGRSEL utility or the value specified in DATA RETN DAYS item of A LOG 3 2 0 SYSLOG Index Maintenance screen The value of this item is 000000 when the SYSLOG is stored After the SYSLOG is restored this value is set to the value specified in parameter of ALOGJRST or ALOGRSEL utility or the value specified in INDEX RETN DAYS item of A LOG 3 2 0 SYSLOG Index Maintenance screen Restore request status e blank lt XISYSLOG data is in A LOG Data Pool A LOG User s Manual Chapter 4 A LOG SYSLOG Storage Facility 4 3 SYSLOG Data The term SYSLOG data refers to the SYSLOGs stored into A LOG Data Pool by ALOGSLOG utility Inquiry of SYSLOG data can be performed using A LOG Terminal Facility Refer to A LOG 3 1 0 screen of Chapter 10 A LOG Terminal Operations for further details A LOG User s Manual 4 5 Chapter 4 A LOG SYSLOG Storage Facility 4 4 ALOGSLOG Utility 4 4 1 Function ALOGSLOG utility is a resident program It performs the following functions e It issues the close command WRITELOG command for SYSLOG at regular interval It selects SYSLOGs from OS Spool and stores them into the A LOG database e Itcreates a SYS
204. oring job logs e By ALOGJRST Utility e By restore instruction from A LOG Terminal Facility e By restore reservation from A LOG Terminal Facility If the job log index is in A LOG Management Database restoration of the job log can be performed by any method If the job log index has been deleted from A LOG Management Database restoration of the job log can be only performed by ALOGJRST utility Restore Job Logs by ALOGJRST Utility Specify the job logs to be restored in a restore parameter and execute ALOGJRST utility The following specific component s can be specified as the option for restoration e Job log index only e Job log data only e Both job log index and data Restore Job Logs by Instruction from A LOG Terminal Facility Restore job logs by selecting the job logs and specifying RESTORE command using 2 1 1 1 2 Job Log Directory or 2 1 2 1 2 Job Log Index No 1 screen of A LOG Terminal Facility In this case only job log data is restored Restore Job Logs by Reservation from A LOG Terminal Facility Reserve job logs for restoration by selecting the job logs and specifying REST ON command using 2 1 1 1 2 Job Log Directory or 2 1 2 1 2 Job Log Index No 1 screen of A LOG Terminal Facility Then execute ALOGRSEL utility to restore the reserved job logs In this case only job log data is restored A LOG User s Manual Chapter 7 A LOG Retention Management Facility 7 5 2 ALOGJRST Utility ALOGJRST utility c
205. pecify interval time in unit of minutes for ALOGSLOG 1 4 utility to issue close command WRITELOG Close command will not be issued if 1440 is specified CLASS Alphanumeric Specify the class of SYSLOGs to be stored by ALOGSLOG 1 utility JOB Alphanumeric Specify the job name of SYSLOGs to be stored by 1 8 ALOGSLOG utility A LOG User s Manual 4 7 Chapter 4 A LOG SYSLOG Storage Facility DDCATS Parameter EXIT CATSLOG SYSUT1 YES NO Specify whether or not to output a SYSLOG record for each job in the SYSUT1 DD statement in DDCATS parameter of an execution procedure If a user exit routine is used the SYSLOG record of SYSUTI DD statement can be read EXT CATSLOG is fixed e YES lt X Output a SYSLOG record This is the default e NO amp l Do not output a SYSLOG record 4 4 3 Operations Initiation S ALOGSLOG 18 29 06 STC 13 S ALOGSLOG 18 29 06 STC 54 JEM100I ALOGSLOG ON STCINRDR 18 29 07 STC 54 JEM373I ALOGSLOG STARTED e When issuing the first WRITELOG command WR IEE0431 A SYSTEM LOG DATA SET HAS BEEN QUEUED TO SYSOUT CLASS R SCT254I SYSLOG STCO0001 ON ALOGSLOG SCT253I ALOGSLOG WAITING FOR WORK CLASS R e When issuing the second or subsequent WRITELOG command 18 29 06 STC 13 WR 18 29 06 STC 54 IEE043I A SYSTEM LOG DATA SET HAS BEEN QUEUED TO SYSOUT CLASS R 18 29 07 STC 54 SCT253I ALOGSLOG WAITING FOR WORK CLASS R Termination P ALOGSLOG 18 29 59 STC 13 P ALOGS
206. pleted SOUT0003 l SOUT0004 Fig 9 2 Handling of Job Log at Time of Abend In this situation shown above the job log and SOUTOOO1 have been stored into A LOG database before the abend The status in job log index reflects that storage of the job log is still in progress Therefore inquiry to job log cannot be performed When ALOGJLOG utility is rerun storage of the job log shall resume and shall continue from SOUTO0002 which was being stored when ALOGJLOG abended earlier After completion of storage of the entire job log inquiry of the job log and SYSOUT dataset can be performed as normal A LOG User s Manual Chapter 9 A LOG Monitoring Facility 9 6 2 Abend of ALOGSLOG Utility Actions by Users Determine the cause of error for the abend of ALOGSLOG utility by referring to A LOG Messages amp Codes Manual Rerun ALOGSLOG utility Actions by A LOG System When ALOGSLOG utility is rerun it resumes storage of the SYSLOG from the remaining SYSLOG dataset of the SYSLOG that was being stored when the utility abended The SYSLOG that is being stored at the time of abend is handled as follows S SYSMO000 SYSMO000 SYSM0001 problem solved SYSMO001 y Re execution Store Abend gt SYSMO002 Again sysm0002 i Start of storage of SYSLOG SYSLOG Index 1 Store End Date Time is blank SYSLOG Index 2 A new index is created and stored SYSM0003 SYSM0003 SYSM0004 1 SYSM0004 Fig 9 3
207. procedure has exceeded 29 bytes A LOG AUTO PARM ERROR Specification of EXEC parameter for A LOG command procedure is incorrect A LOG MENU NO PARMERROR Menu number specified in EXEC parameter for A LOG command procedure is incorrect A LOG USLP SESSION END Processing of A LOG Terminal Facility has ended A LOG NO MAP AREA GOTTEN Unable to allocate work area for screen mapping A LOG MAP NAME NOT MATCH The called map name does not match the name defined in screen map library A LOG MAP LIBRARY Unable to write data into screen map library A LOG ATTENTION REQUIRED An interrupt has been detected during a terminal session because the attention key is pressed A LOG GETMAIN ERROR SIZE A GETMAIN error has occurred while setting up a screen getmain size A LOG GETMAIN SIZE OVER Size of GETMAIN has exceeded 268 435 bytes when setting up a 268435 screen A LOG IS NOT ACTIVE A LOG Monitor is not active Kanji Support A LOG Terminal Facility supports English screens as well as Kanji screens Either type can be selected by a command procedure The relevant command procedure name must be set at the time of installation of A LOG System This manual explains English screens only A LOG User s Manual Chapter 10 A LOG Terminal Operations 10 4 Starting Ending a Session Starting a Session When the TSO TSS terminal is in READY state enter the command procedure name for A LOG Terminal Facility and press ENTER key The first
208. rations e Operations on job logs already stored into A LOG database e Operations on job log indexes that manage the job logs in A LOG database Generally this function is used to e Inquire job logs e Print job logs e Delete job logs e Inquire change attributes or delete job log indexes SYSLOG Management Function This function is used to manage SYSLOGs with the following operations e Operations on SYSLOGs already stored into A LOG database e Operations on SYSLOG indexes that manage the SYSLOGs in A LOG database Generally this function is used to e Inquire SYSLOGs e Print SYSLOGs e Delete SYSLOGs e Inquire change attributes or delete SYSLOG indexes System Management Function This function is used to set PF keys for terminals using A LOG Terminal Facility A LOG User s Manual Chapter 10 A LOG Terminal Operations Security Management Function This function is used to control and restrict the use of A LOG Terminal Facility by each User ID of TSO TSS terminals Access control and authorization are performed by defining primary and secondary resources that can be used by a TSO TSS terminal user Using the AUTOSECR utility a Security Officer can define the primary and secondary resources for each TSO TSS terminal user In this way the TSO TSS terminal user is restricted in the use of A LOG Terminal Facility as follows e Access to A LOG Terminal Facility must be authorized by Security Officer e Access to specific
209. rces A LOG System specializes in managing job logs and SYSOUTs which are generated as a result of job executions and SYSLOGs A LOG System automatically retrieves and stores job logs SYSOUTs and SYSLOGs into an A LOG database It also supports inquiry and print functions from TSO TSS terminal The components of A LOG System are shown as follows OS Spool A LOG Master Management Facility A LOG Job Log SYSLOG Job Log Master Storage Facility SYSLOG Master A LOG Database A LOG Management Database A LOG Retention Management Facility A LOG Monitoring Facility A LOG Data Pool LO Job Log SYSLOG A LOG Terminal Facility Print Facility gt A LOG Security Protection Facility Fig 1 1 Components of A LOG System A LOG Audit Trail Management Facility LLN o A LOG User s Manual 1 1 Chapter 1 A LOG System Facilities 1 2 A LOG System Facilities A LOG System offers the following system facilities for management of job logs and SYSLOGs A LOG Monitoring Facility A LOG Terminal Facility A LOG Security Protection Facility A LOG Master Management Facility A LOG Job Log Storage Facility A LOG SYSLOG Storage Facility A LOG Job Log Print Facility A LOG SYSLOG Print Facility A LOG Retention Management Facility A LOG Audit Trail Management Facility Each of the above facilities is explained as follows A LOG Monitoring Facility A LOG Monitor is a resident program which acts as t
210. rd member name CLASS class Specify the classes of job logs to be selected from OS Spool for storage into A LOG database Up to a maximum of 8 classes can be specified When more than one classes are specified specify the values continuously P job definition card member name Specify the member name of a job definition card for ALOGJLOG utility Default is DDJLOGI 3 8 A LOG User s Manual Chapter 3 A LOG Job Log Storage Facility Job Definition Cards These cards define the selection criteria for the Job Log Master records to be referenced when storing job logs into A LOG database If these cards are not defined the default Job Log Master record with Job Log ID equals JOBLOG is used The selection criteria are a part of job name and SYSOUT class Format amp Item Name Col Length Description Card Information 1 Alphabetic Specify PS ID 2 Job Log ID 3 Alphanumeric Specify Job Log ID of Job Log Master record to be 8 referenced Class Number 11 Numeric Specify the number of SYSOUT classes as specified in 6 item Alphanumeric Specify the SYSOUT classes of the job logs to be stored 8 into A LOG database from OS Spool 3 Position 25 Numeric Specify the starting column position for the character string as specified in item lt gt Length Specify the length of character string as specified in item 3 lt lt gt Character String 31 Alphanumeric Specify the charact
211. re Index Retention Period as specified in restore parameter e After Restore Data Retention Period as specified in restore parameter Output Restore Proof List An output listing of showing the restored SYSLOGs is generated Output Dump MT Inquiry List An output listing of the Dump MT Inquiry List can be requested However output of a Dump MT Inquiry List and the SYSLOG restore proof list cannot be performed at the same time Refer to 7 5 7 Dump MT Inquiry List for further details A LOG User s Manual 7 27 Chapter 7 A LOG Retention Management Facility 7 6 3 Restore Instruction from A LOG Terminal Facility Restoration of SYSLOGs can be performed immediately from A LOG Terminal Facility A RESTORE command from A LOG Terminal Facility will submit ALOGLRST utility automatically to restore the selected SYSLOGs immediately This command is applicable only to those SYSLOGs with DUMP MT as the current Storage Location If the dataset name label number first volume serial number of the Dump MT are the same for several selected SYSLOGs these SYSLOGs can be restored together in one single execution of ALOGLRST utility A maximum of 100 SYSLOGs can be restored at any one time The JCLs for submission of ALOGLRST utility must be defined in a library a standard library is A LOG Parameter Library This library must be specified in DDWTR DD statement of the command procedure of A LOG Terminal Facility Specify member name of the
212. re four types of retention periods that are supported by A LOG system These retention periods correspond to the status of job logs or SYSLOGs in A LOG database These are described as follows Dump Retention Period This defines the number of days for keeping a job log or SYSLOG data in A LOG Data Pool without dumping it out onto a Dump MT For those job log or SYSLOG data that have passed this retention period they can be dumped onto a Dump MT magnetic tape and deleted from A LOG Data Pool by executing ALOGJDMP ALOGDMP1 2 or ALOGLDMP utility The information at the time of dumping is written into job log and or SYSLOG indexes in the A LOG Management Database Delete Retention Period This defines the number of days for keeping a job log or SYSLOG in A LOG Management Database and A LOG Data Pool without deleting them For those job logs or SYSLOGs that have passed this retention period their job log or SYSLOG indexes and data can be deleted from A LOG Management Database and A LOG Data Pool by executing ALOGDLTS or ALOGDMP3 utility After Restore Index Retention Period This defines the number of days for keeping a job log or SYSLOG index in A LOG Management Database without deleting it after it has been restored For those job log or SYSLOG indexes that have passed this retention period the job log or SYSLOG indexes and data can be deleted from A LOG Management Database and A LOG Data Pool by executing ALOGDLTS utility After Restore
213. reader to execute the ALOGJRST ALOGLRST utility If a group has more than 100 job logs SYSLOGs a separate job is generated for each batch of 100 To generate the restore job ALOGRSEL utility uses the JCLs of a sample job in the library specified in DDJCL DD statement This dataset is usually the A LOG Parameter Library The member name of the sample job is specified in the JOBNM keyword of the ALOGRSEL parameter card If the JOBNM keyword is omitted or the specified member does not exist member ALOGJRST for job log or ALOGLRST for SYSLOG is used The member name is used as the job name of the generated job ALOGRSEL utility also generates the necessary restore parameter cards in the DDCNTL DD statement of the generated job A list of job logs S YSLOGs selected for restoration is output to Restore Job Creation Proof List ALOGRSEL Parameter Card A LOG Management Database DDJCL DDCNTL Restore Job e Utility Dynamic Allocation Restore Job Internal Reader Creation Proof List A LOG Data Pool ESO a ALOGJRST Job Log Data ALOGLRST SYSLOG Data 11 18 2 Processing Requirement Sample Job Log Index SYSLOG Index SYSPRINT ALOGRSEL Utility Fig 11 21 Processing Outline of ALOGRSEL Utility A LOG User s Manual 11 69 Chapter 11 A LOG System Utilities The procedure for executing ALOGRSEL utility is as follows 1 Specify the ALOGRSEL parameter card in DDCNTL DD statement 2
214. red if there is no error in the contents of the items Otherwise registration is not performed Updating of a Job Log Master or SYSLOG Master Record COMMAND Specify SAVE command Update the contents of the master record accordingly specify the above and press ENTER key The master record will be updated if there is no error in the contents of the modified items All items can be changed except the JOB SYSLOG ID and VALID DATE items A LOG User s Manual 10 21 Chapter 10 A LOG Terminal Operations Screen Messages INVALID COMMAND An invalid command has been specified DATA CHECK ERROR An error has been detected in the content of an item in Job Log Master or SYSLOG Master SAVE COMMAND COMPLETE Registration or update of job log or SYSLOG master record has completed SAVE COMMAND ERROR RSP An error response code RSP xxx was returned while registering XXX or updating a job log or SYSLOG master record 10 22 A LOG User s Manual Chapter 10 A LOG Terminal Operations 10 6 Job Log Management 2 0 0 Job Log Management Screen A LOG 2 0 0 JOBLOG MANAGEMENT 96 09 04 14 08 15 COMMAND gt SELEC JOBLOG INDEX MAINTENANCE DUMP MT INQUIRY Function This screen is displayed when 2 is specified in SELECT item of 0 0 0 Initial Menu screen It is used to specify job log maintenance or Dump MT inquiry options Screen Operations From this screen you can proceed to 2 1 0 Job Log
215. reference date is not specified the Operation Date at the time of utility execution is used 7 12 A LOG User s Manual Chapter 7 A LOG Retention Management Facility Select SYSLOGs Using DMPSYS Parameter SYSLOGs that have passed the retention period can be selected for dumping by specifying one or more of the following selection criteria in DMPSYS parameter e By job name e By SYSLOG ID e By remaining retention days e By Dump Retention Period Dump SYSLOG Index and Data Dumping of both SYSLOG index and data into a magnetic tape is possible SYSLOG data are compressed at this time Dumping into multiple magnetic tapes up to a maximum of 10 is supported Set Dump MT Information in SYSLOG Index The dataset name volume serial number label number of Dump MT can be set in the SYSLOG index Create Dump MT Information Record A Dump MT Information Record can be created in the Dump MT Information File in A LOG Management Database Refer to 7 4 5 Dump MT Information for further details Generate Dump Proof List An output listing of the SYSLOGs which have been dumped can be generated Refer to ALOGLDMP utility in Chapter 11 A LOG System Utilities for further details Delete SYSLOG Data ALOGLDMP utility consists of the following two 2 steps Step 1 Dump processing is performed Step 2 SYSLOG data which has been dumped are deleted and the cataloging place of SYSLOG index is changed from BKS to DUMP MT
216. riod lt Processing Date If the Dump Retention Period is 29 or less and reference to Holiday Master is specified in EXEC parameter the retention period is calculated using working days only However if the job log is stored on a holiday that day itself is counted as one retention day The following example shows the calculation of retention periods using working days for job logs A and B Holiday Master Jajaj o o S A Dump Retention Period 5 days 7 Dump Retention AE MM Storage Date Legend C Dump Retention Period Expire Date The circled number indicates the number of working days the job log has been retained after that date e g for job log A after 11 May the job log has been retained for 2 working days The 13 and 14 are holidays and hence not counted as retention days dotted line in diagram However for job log B the 13 is counted as one retention day because the job log was stored on that day Note When the Processing Date is on or before 31 December 1999 Holiday Master for A AUTO Version 5 2 0 or later can be used However if the Processing Date is on or after 1 January 2000 Holiday Master for A AUTO Version 6 0 or later must be used A LOG User s Manual 11 35 Chapter 11 A LOG System Utilities 2 The job logs to be dumped can be selected based on one or more of the following criteria specified in the Dump parameter cards e Job name e Job number
217. rminate A LOG Terminal Facility EXIT To switch to 0 0 0 Initial Menu screen To switch to menu screen corresponding to the specified menu number A LOG User s Manual 10 13 Chapter 10 A LOG Terminal Operations 10 14 Input Output Items Length SELECT FUNCTION 1 Alphabetic Select one of the following function codes A Registration D Deletion A Modification or Inquiry JOB SYSLOG ID Alphanumeric Specify a job log or SYSLOG ID VALID DATE 6 Numeric Specify a valid date in yymmdd format 1 8 COPY ID Alphanumeric During registration if the master record serving as source for copying already exists specify its job log or SYSLOG ID Screen Operations Registration of a Job Log Master or SYSLOG Master Record Required Item Specification SELECT FUNCTION Specify A JOB SYSLOG ID Specify a job log or SYSLOG ID of the job log or SYSLOG master record to be registered VALID DATE Specify a valid date for the job log or SYSLOG master record to be registered Specify the above and press ENTER key Processing depends on the following conditions e If the Job Log Master or SYSLOG Master record with the specified job log or SYSLOG ID already exist a If there is only one master record Contents of the master record will be displayed on 1 1 2 Job Log SYSLOG Master screen After changing the contents enter SAVE command and press ENTER key Registration of master record is perfor
218. rol is returned to this screen after pressing the ENTER key A LOG User s Manual 10 77 Chapter 10 A LOG Terminal Operations Flow of System Management Screens The following figure shows the flow of system management screens Legend XXXX Command EXIT or MENU 9 0 0 System Management 9 1 0 Terminal PF Keys Setting Fig 10 10 Screen Flow of System Management Function 10 78 A LOG User s Manual Chapter 10 A LOG Terminal Operations 9 1 0 Terminal PF Keys Setting Screen A LOG 9 1 0 ERMINAL PF KEYS SETTING 96 09 04 14 22 50 COMMAND gt TERMINAL TYPE gt TR TABLE SERFIX gt KANJI CODE gt MAX BUFFER LEN gt 00004096 obo te th te bt ot ot te ot tea VVVVVVV VV VV Vv Function This screen displays the current settings of the PF keys for a user of A LOG Terminal Facility It is used for setting or changing the PF key settings Screen Commands MENU To switch to 0 0 0 Initial Menu screen XEXIT To terminate A LOG Terminal Facility EXIT To switch to 0 0 0 Initial Menu screen SAVE To register update PF key definitions To switch to screen corresponding to the specified menu number A LOG User s Manual 10 79 Chapte 10 80 r 10 A LOG Terminal Operations Input Output Items TERMINAL TYPE ER Alphanumeric Specify the terminal type or leave it blank TR TABLE SERFIX Specify the translation table to be used for converting
219. ry for WTRJUTL Utility If WTRJUTL utility is to be submitted by the job log storage exit routine specify the JCL library of the WTRJUTL utility by DDWTR DD statement of the execution procedure If not specify DUMMY SYSUT1 DD Statement If SYSUTI file is to be read by the job log storage exit routine change the BLKSIZE if needed Specify a block size in multiple of 142 bytes A LOG User s Manual Chapter 3 A LOG Job Log Storage Facility 3 4 2 Operations Initiation S ALOGJLOG CLASS class P job definition card member name CLASS class Specify the classes of job logs to be selected from OS Spool for storage into A LOG database Up to a maximum of 8 classes can be specified When more than one classes are specified specify the values continuously P job definition card member name Specify the member name of a job definition card for ALOGJLOG utility Default is DDJLOGI 13 S ALOGJLOG 54 JEM100I ALOGJLOG ON STCINR 54 JEM373I ALOGJLOG STARTED 174 JEM100I ALOGJOB1 ON INTRDR 174 JEM3731 ALOGJOB1 STARTED INIT 174 JEM3951 ALOGJOB1 ENDED 54 SCT205I ALOGJOB1 ON ALOGJLOG 174 JEM2501 ALOGJOB1 IS PURGED 54 SCT201I ALOGJLOG WAITING FOR WORK CLASS J Al Al Al Al Termination P ALOGJLOG 18 29 59 STC 13 P ALOGJLOG 18 30 00 STC 54 JEM395I ALOGJLOG ENDED Changing Class F ALOGJLOG CLASS class CLASS class Specify the classes of job logs to be selected from OS Spool for
220. s FUNCTION selection D Deletion A Inquiry or Modification LOG DATE Alphanumeric Specify job log storage date as a selection criterion in yymmdd format JOB NAME 1 8 Alphanumeric Specify job name as a selection criterion A prefix maybe specified by entering an immediately after the character string JOBLOG ID 1 8 Alphanumeric Specify job log ID to be used as selection criterion A prefix maybe specified by entering an immediately after the character string JOB CLASS Alphanumeric Specify job class as a selection criterion COND CODE Alphanumeric Specify one of the following completion codes as a selection criterion A search entire indexes number search using the specified number AB search for abended job only ER search for jobs with JCL error JOB FAILED or CANCEL status string search using the specified character string SELECT KEY 1 Alphanumeric Specify one of the following comparison operators for the OF COND completion code CODE A equal to the specified completion code G greater than the specified completion code L less than the specified completion code N not equal to the specified completion code START DATE Numeric Specify job start date as a selection criterion in yymmdd format START TIME 6 each Numeric Specify job start time and end time as selection criteria in FROM TO hhmmss format If only job start time is specified job end time equals 11 59 p
221. s These are utilities for dumping and deleting job logs It consists of the four 4 utilities ALOGDMP1 4 The function of each procedure is shown below ALOGDMP1 Converts A LOG Management Database into sequential file Thereafter generates three 3 files based on this sequential file for use by ALOGDMP2 4 utilities Same function as ALOGJDMP utility i ALOGDMP2 Dumps job logs based on the file generated by ALOGDMP1 utility Thereafter deletes the dumped job logs from A LOG Management Database Same as job log ALOGDMP3 Deletes job log index and data which have passed the A delete function retention period from A LOG Management Database based Sf ALOGDLTS on the file generated by ALOGDMP1 utility utility Fig 7 6 Structure of Fast Dump Delete Utilities Note A LOG Monitor must be terminated before executing ALOGDMP1 utility Fig 7 6 shows the execution of fast dump delete utilities Refer to ALOGJDMP1 4 utilities in Chapter 11 A LOG System Utilities for further details 7 10 A LOG User s Manual Chapter 7 A LOG Retention Management Facility A LOG Management Database DMPJOB Parameter File A ALOGDMP1 a Work Utility ALOGDMP4 Utility a Job Log Index File Dump Target amp Delete Target after Restoration EXEC A LOG EXEC me Database ALOGDMP2 JobLocIndex Avoca Utility Avoca Index File of gt Job Log
222. s Refer A LOG System Administrator s Manual for the format of the release file 8 1 3 ALOGLLOG Utility ALOGLLOG utility generates SYSLOG Audit Trail List and creates the SYSLOG Index Release File based on the information of SYSLOG indexes in A LOG Management Database Refer to ALOGLLOG Utility in Chapter 11 A LOG System Utilities for further details Refer A LOG System Administrator s Manual for the format of the release file A LOG User s Manual Chapter 9 A LOG Monitoring Facility System Console A LOG Monitor Commands y AA A LOG Monitor ALOGSLOG ALOGJLOG Utility Utility sera A LOG eerie A LOG Database Management Data Pool Database Chapter 9 A LOG Monitoring Facility 9 1 A LOG Monitoring Functions A LOG Monitor is a key component and a nucleus of A LOG System It performs A LOG Monitor command processing and it monitors the storage of job logs and SYSLOGs The A LOG Monitor must be started first before the commence of operations using A LOG System A LOG Monitor provides the following functions e It monitors the storage of job logs or SYSLOGs e It monitors the space utilization in A LOG Management Database and A LOG Data Pool System Console A LOG Monitor Commands i aoe Monitor ALOGSLOG ALOGJLOG Utility Utility A LOG A LOG E Database Management Database Data Pool Fig 9 1 Overview of A LOG Monitoring Facility A LOG User s Manual 9 1 Chapter 9 A
223. s in USMSCARD DD statement as required 3 Specify the input Dump MT information in DDIN DD statement if required and 4 Run ALOGLRST utility A LOG User s Manual Chapter 11 A LOG System Utilities 11 17 3 Input Requirement 1 Restore Parameter Cards Specify these cards in DDCNTL DD statement Each card has the following format RESTORE keyword value keyword valuel Each card must begin with RESTORE in column 1 A keyword value pair must be specified within columns 9 to 72 Multiple keyword value pairs can be specified on one card by coding them one after another separated by commas To continue a keyword value pair on the next card end the current card with a comma Format amp Keyword Length Description Alphanumeric Specify the job name of the SYSLOG to be restored This item can be 1 8 omitted if SID keyword is specified In this case it defaults to SYSLOG Alphanumeric Specify the SYSLOG ID of the SYSLOG to be restored 1 8 MAKED Numeric Specify the Storage Date of the SYSLOG to be restored in yymmdd 6 format MAKET Specify the Storage Time of the SYSLOG to be restored in hhmmss 6 format INDEX Alphabetic Specify the restore object 1 4 YES Restore SYSLOG data and index NO Restore SYSLOG data only default ONLY Restore SYSLOG index only KEEPD Numeric Specify the number of days between 0 1830 to retain the SYSLOG 1 4 data after restoration default is 0 K
224. s specifies the number of days the job logs or SYSLOGs and their indexes are to be retained in A LOG database After this period has expired ALOGDLTS utility shall delete the expired job logs or SYSLOGs and their indexes from A LOG database e After Restore Data Retention Period This specifies the number of days the job logs or SYSLOGs are to be retained in A LOG database after restoration from Dump MT After this period has expired ALOGDLT1 utility shall delete the expired job logs or SYSLOGs from A LOG database e After Restore Index Retention Period This specifies the number of days the job logs or SYSLOGs indexes are to be retained in A LOG database after restoration from Dump MT After this period has expired ALOGDLTS utility shall delete the expired job logs or SYSLOGs indexes from A LOG database Refer to Chapter 7 A LOG Retention Management Facility for further details A LOG Audit Trail Management Facility This facility provides the following audit trail management functions and information on job logs and SYSLOGs stored in A LOG database e Job Log Audit Trail List e Job Log Index Release File e SYSLOG Audit Trail List e SYSLOG Index Release File Refer to Chapter 8 A LOG Audit Trail Management Facility for further details A LOG User s Manual 1 5 Chapter 1 A LOG System Facilities 1 3 Support for Multiple CPUs 1 3 1 Using JESMAS Spool or SYSOUT Data Transmission When JESMAS is used or whe
225. screen to be displayed will depend on the setting defined during installation of A LOG System Fig 10 2 highlights the general screen flow of A LOG Terminal Facility TSO TSS ENTER Key Xxxx Command XEXIT A SPOOL A LOG Select XEXIT X 10 0 0 X Initial Menu 1 0 0 2 0 0 3 0 0 9 0 0 Job Log SYSLOG Job Log SYSLOG System Master Management Management Management Management 1 1 0 2 1 0 2 2 0 3 1 0 3 2 0 9 1 0 Job Log SYSLOG Job Log Index Dump MT SYSLOG SYSLOG Index Terminal PF Keys Master Maintenance Maintenance Inquiry Data Select Maintenance Setting Fig 10 2 Screen Flow of A LOG Terminal Facility If the first screen displayed after starting of A LOG Terminal Facility is the Hello or A SPOOL A LOG Select screen enter a User ID and Group ID for security check by A LOG Security Management Facility If A LOG Security Management Facility is not implemented then you do not need to specify the User ID and Group ID If the first screen displayed after starting of A LOG Terminal Facility is any screen other than the Hello or A SPOOL A LOG Select screen A LOG Security Management Facility will perform authorization check using the Logon ID of the user if A LOG Security Management Facility is implemented Otherwise no authorization check is performed A LOG User s Manual 10 7 Chapter 10 A LOG Terminal Operations Hello Screen 96 09 04 13 59 29 ADVANCED JOBLOG MANAGEMENT SYSTEM 0000000
226. screens of A LOG Terminal Facility must be authorized by Security Officer e Inquiry update and other operations on A LOG master files must be authorized by Security Officer Refer to A LOG System Administrator s Manual for further details on the primary and secondary resources Refer to A BAS Security Management Facility User s Manual for further details on AUTOSECR utility If there is a security violation or other reasons preventing a TSO TSS terminal user from using certain functions of A LOG Terminal Facility A LOG Security Management Facility will display one of the following error messages on the screen SECURITY VIOLATION No authority to use specified resource EFFECTIVE DATE OVER Valid Date of User ID has passed EFFECTIVE TIME OVER Valid Time of User ID has passed USER ID NOT RESISTERED Specified User ID not registered in Security Management Table USER ID IS HOLD Specified User ID is on Hold CONTROL RECORD NOTHING _ No control record is found in Security Management Table A LOG User s Manual 10 3 Chapter 10 A LOG Terminal Operations 10 3 10 4 Overview of Screens Basic Screen Layout The basic layout of a screen in A LOG Terminal Facility is shown as follows yy mm dd hh mm ss Item Number Product name A LOG and menu number are displayed Screen title is displayed CPU date and time are displayed Display data is refreshed when ENTER key is pressed For date
227. set A LOG User s Manual For the job log data which has been printed PRT is displayed rae Chapter 3 A LOG Job Log Storage Facility 3 3 Job Log Data The term job log data refers to the job logs and SYSOUT data stored into A LOG Data Pool by ALOGJLOG utility Inquiry of job log data can be performed using A LOG Terminal Facility Refer to A LOG 2 1 0 screen of Chapter 10 A LOG Terminal Operations for further details The job log data managed by A LOG System are as follows e Job logs e JCL listings e System messages e SYSOUT data 3 6 A LOG User s Manual Chapter 3 A LOG Job Log Storage Facility 3 4 ALOGJLOG Utility 3 4 1 Function ALOGJLOG utility is a resident program It performs the following functions Itselects job logs from OS Spool and stores them into the A LOG database job by job It creates a job log index for each job log by referring to a master record specified in a job definition card The type of information to be created in the job log index depend on the selection criteria specified in job log message definition card The following type of information may be selected Job start date time Job end date time Job completion code Abend code JCL error Storage of a Job Log without a Job Log Master Record When ALOGJLOG utility stores a job log into A LOG database the Job Log Master record to be referenced for the job log is selected based on the specification in a job d
228. ssages Error Message Screen A LOG EMSG ERROR ME 96 09 04 14 23 53 COMMAND gt ERR CODE MESSAGE J13 SYSOUT CLASS ERROR MUST BE 0 TO 9 OR A TO Z KeEKKKKKK END OF DATA XX XXXXX X x Function This screen displays the error messages and information for an error item on a screen It is displayed only if EMSG command is specified when the DATA CHECK ERROR message is displayed on a screen Screen Commands To switch to 0 0 0 Initial Menu screen io Tee ups To scroll up one page To scroll down one page A LOG User s Manual 10 81 Chapter 10 A LOG Terminal Operations 10 82 Input Output Items Length ERROR CODE 3 Alphanumeric Error code will be displayed 3 Numeric If an error code is repeated on the screen the sequence number will be displayed MESSAGE Alphanumeric Error message will be displayed Refer to the following table for further details Error Codes amp Messages Error Message Description EE o DATE VALID DATE ERROR rr att bac in Valid Date 32 JOBLOG ID ERROR Error in Error in job log or SYSLOG ID log or SYSLOG ID JOB CLASS ERROR Error in job class MUST BE 0 TO 9 OR A TO Z SYSOUT CLASS ERROR Error in SYSOUT class MUST BE 0 TO 9 OR A TO Z J18 RETENTION DUMP OR DELETE ERROR Error in Dump Retention Period or Delete MUST BE NUMERIC Retention Period RETENTION DUMP OR
229. st in the job log A LOG User s Manual 10 49 Chapter 10 A LOG Terminal Operations 2 2 0 Dump MT Inquiry Screen A LOG 2 2 0 DUMP MT INQUIRY 96 09 04 14 16 12 COMMAND gt DUMP DATE VOL SER EXPIRATION 960831 WORKO3 960904 960831 WORKO3 960906 KeRKKKKKE END OF DATA x xxxxx Function This screen is displayed when 2 2 is specified in SELECT item of 0 0 0 Initial Menu screen It is used viewing and deletion of Dump MT Information Screen Commands To switch to 0 0 0 Initial Menu screen To terminate A LOG Terminal Facility To switch to 2 0 0 Job Log Management screen Scroll down one page To delete the Dump MT information 10 50 A LOG User s Manual Chapter 10 A LOG Terminal Operations Input Output Items tem Length o oo Ja I Alphabetic To delete Dump MT information specify D DUMP DATE alle Dumped date is displayed VOL SER aR Volume serial number of Dump MT is displayed EXPIRATION Among the job logs dumped onto the Dump MT the highest expiration date is displayed LABEL ce Si e Label number of volume is displayed Screen Operations Deletion of Dump MT Information Required Item Specification op Speciy Dr COMMAND Specify DELETE command Specify the above and press ENTER key The Dump MT information will be deleted Screen Messages DELETE COMMAND ERROR RSP xxx An error has occurred while deleting Dump MT information record DMM
230. st of the restored job logs is output to Job Log Restore Proof List Limitation All job logs to be restored together must have been dumped by the same run of the dump utility ALOGJDMP 11 14 2 Processing Requirement 11 50 A LOG Management Restore Database Parameters y e ee Job Log Index USMSJRST ALOGJRST r a tilit Parargeter ay oe A LOG Data Pool a US AN Job Log Data Job Log Restore Dump MT Proof List Inquiry List Fig 11 17 Processing Outline of ALOGJRST Utility The procedure for executing ALOGJRST utility is as follows 1 Specify the Restore parameter cards in DDCNTL DD statement 2 Modify the USMSJRST parameter card in USMSCARD DD statement as required 3 Specify the input Dump MT information in DDIN DD statement as required and 4 Run ALOGJRST utility A LOG User s Manual Chapter 11 A LOG System Utilities 11 14 3 Input Requirement 1 Restore Parameter Cards Specify the Restore parameter cards in DDCNTL DD statement Each card has the following format RESTORE keyword value keyword valuel Each card must begin with RESTORE in column 1 A keyword value pair must be specified within columns 9 to 72 Multiple keyword value pairs can be specified on one card by coding them one after another separated by commas To continue a keyword value pair on the next card end the current card with a comma Format amp Keyword Length Description A
231. ster record DUMP DELETE RETENTION Delete Retention Period of the SYSLOG Master record DAYS DELETE CATLG START DATE CPU date when storage of the SYSLOG is started CATLG END DATE CPU date when storage of the SYSLOG is ended A LOG User s Manual 4 3 Chapter 4 A LOG SYSLOG Storage Facility Modifiable START TIME CPU time when storage of the SYSLOG is started i END TIME CPU time when storage of the SYSLOG is ended A STATUS CATLG STATUS PLACE DESTINATION CODE SYSLOG COMMENT Storage status of the SYSLOG e START lt Storage has started e ABEND lt JStorage has abended e END lt I Storage has ended Storage location of the SYSLOG e blank lt x Not yet stored or already deleted e BKS lt I In A LOG database e DUMPMT amp lIn Dump MT Destination Code of the SYSLOG Master record For this version unless LOCAL is set in this field otherwise it will be filled up with blanks SYSLOG comment of the SYSLOG Master record USER COMMENT User comment of the SYSLOG Master record DUMP DSNAME Dataset name of the Dump MT where SYSLOG data is stored VOL SER Volume serial number of the Dump MT where SYSLOG data is stored LABEL Label number of the Dump MT where SYSLOG data is stored RESTORE REQUEST RESTORE STATUS e ON amp lRestore reservation is ON e OFF lt XRestore reservation is OFF Status of restoration e INDEX lt X Index has been restored e DATA lt X Data has been rest
232. ster used during generation of index is displayed JOB START DATE PU msed blank Unused blank JOB END DATE Unused blank A LOG User s Manual Chapter 10 A LOG Terminal Operations tem Length O EA TE a OO PAGE COUNT Number of pages of stored SYSLOG page number divided internally by A LOG is displayed LINE COUNT LINECOUNT Number of lines of stored SYSLOG is displayed Number of lines of stored SYSLOG is displayed SYSOUT CLASS ol SYSOUT class of SYSLOG is displayed DATASET COUNT Number of datasets in SYSLOG identical to the number of times WRITELOG has been issued is displayed JOB CLASS 1 Numeric Job class of SYSLOG is displayed This item may be modified RETENTION DAYS 4 Numeric Dump Retention Period is displayed This item may DUMP be modified by specifying a value between 0000 to 1830 This item is not applicable to SYSLOG after restoration because the After Restore Index Retention Period and After Restore Data Retention Period items become valid In this case a message NOT REFERRED is displayed RETENTION DAYS 4 Numeric Delete Retention Period is displayed This item may DELETE be modified by specifying a value between 0000 to 1830 This item is not applicable to SYSLOG after restoration because the After Restore Index Retention Period and After Restore Data Retention Period items become valid In this case a message NOT REFERRED is displayed CATLG START DATE S
233. storage into A LOG database Up toa maximum of 8 classes can be specified When more than one classes are specified specify the values continuously A LOG User s Manual 3 19 Chapter 4 A LOG SYSLOG Storage Facility Operating _SYSLOGs SYSLOG Job 1 System SYSLOG Job 2 Specific Classes of SYSLOGs WRITELOG command for SYSLOG issued at regular interval ALOGSLOG Utility Resident Program A LOG Management Database SYSLOG SYSLOG Master Index Reference Create A LOG Data Pool SYSLOG Data 1 SYSLOG Data 2 A LOG Terminal Facility LLEN e Inquiry e Print Instruction Chapter 4 A LOG SYSLOG Storage Facility 4 1 Introduction Storage of SYSLOGs into the A LOG database is performed by ALOGSLOG utility This utility is a resident program It issues WRITELOG command at a certain interval It selects specific classes of SYSLOGs from the OS Spool and then stores the selected SYSLOGs into A LOG database For each SYSLOG stored into A LOG database a SYSLOG index is also created and managed by A LOG System OS Spool SYSLOG 1 SYSLOG 2 Operating SYSLOGs System WRITELOG command for SYSLOG issued Specific Classes of SYSLOGs at regular interval ALOGSLOG Utility Resident Program Create A LOG Management Database SYSLOG SYSLOG Master Index A LOG Data Pool SYSLOG Data 1 SYSLOG Data 2 A LOG Terminal Facility LLEN
234. t EXEC Parameter i ES A SYSPRINT Dump MT Dump MT Information lt gt ALOGDLT4 Information Utility Deletion Proof List A LOG Management Database Fig 11 6 Processing Outline of ALOGDLTA4 Utility The procedure for executing ALOGDLT4 utility is as follows 1 Specify the processing date in EXEC parameter 2 Specify the type of output listing in EXEC parameter and 3 Run ALOGDLT4 utility A LOG User s Manual Chapter 11 A LOG System Utilities 11 7 3 Input Requirement The EXEC parameters for ALOGDLT4 utility ALOGDLT4 PDATE yymmdd PRINT Y N where PDATE gt Processing Date If omitted the current A LOG Operation Date is used PRINT gt Type of output listing Y List all Dump MT Information records N List only deleted Dump MT Information records Default 11 7 4 Output Listing A sample output listing of Dump MT Information Deletion Proof List is shown on the following page A LOG User s Manual 11 11 Chapter 11 A LOG System Utilities Dump MT Information Deletion Proof List A LOG ADVANCED JOBLOG SYSLOG MANAGEMENT SYSTEM VERSION 03 80 BY BSP INC DATE 96 10 26 TIME 22 49 40 PAGE DMM DELETION LIST USMS DATE 96 10 10 LIST CODE DLT040 e 5 DATE VOLSER LABEL PURGE STATUS 960830 B00860 001 960831 LETE 960830 B00861 001 960830 LETE 960929 ASDO51 001 960926 LETE 960929 ASDO52 002 960928 LETE 960929 ASDO53 001 960928 LETE 960929 ASDO54 002 960928
235. ter gt lt gt _ _ _ Pr Utility SYSLOG Master an Master Master Definition Card Mainternance Master Check List Proof List Inquiry List Fig 11 16 Processing Outline of ALOGJMST Utility The procedure for executing ALOGJMST utility is as follows 1 Specify the Master definition cards 2 Specify the required parameters in EXEC statement and 3 Run ALOGJMST utility A LOG User s Manual Chapter 11 A LOG System Utilities 11 13 3 Input Requirement 1 Master Definition Cards Specify the Master definition cards in SYSIN DD statement The Master definition cards for registration deletion and inquiry are described below Master Definition Cards for Registration Format amp No Item Name Col Length Description Master Type Alphabetic Specify J 1 Processing Type Alphabetic Specify A 1 Sequence No 3 Numeric Specify a sequence number to be assigned to each 3 combination of Job Log SYSLOG ID and Valid Date Different types of definition cards belonging to the same Job Log SYSLOG ID and Valid Date must have the same sequence number Y Card ID Pager Specify a Card ID to identify the type of information specified in the definition card O Job Log SYSLOG ID Valid Date etc 1 Immediate print criteria 2 Job Log SYSLOG comment 3 User comment LBP information Data Area Alphanumeric The format and content of this item depend on Card 1 64 ID as
236. that for ALOGJDMP utility A LOG Monitor must be shut down before executing this utility Otherwise the utility will display the message SSB102I ALOG IS ACTIVE on the console every 10 seconds until A LOG Monitor is shut down 11 10 1 2 Processing Requirement 11 22 Dump Parameters EXEC Parameter A LOG Management Database Holiday ALOGDMP1 Job Log Index Job Log Selected Job Data Index Job Log Index All Job Logs Logs Fig 11 10 Processing Outline of ALOGDMP1 Utility A LOG User s Manual Chapter 11 A LOG System Utilities The procedure for executing ALOGDMP1 utility is as follows 1 Shut down A LOG Monitor 2 Specify the Dump parameter cards 3 Specify the A AUTO Holiday Master as required 4 Specify the processing date and the option to reference A AUTO Holiday Master in EXEC parameters and 5 Run ALOGDMP1 utility 11 10 1 3 Input Requirement 1 Dump Parameter Cards These parameter cards are specified in DDCNTL DD statement They are the same as that for ALOGJDMP utility Please refer to ALOGJDMP utility for details 2 Holiday Master Specification The required Holiday Master is specified in HOLTABLE DD statement as follows HOLTABLE DD DSN holiday master dataset name member name DISP SHR 3 EXEC Parameters ALOGDMP1 PDATE yymmdd HOLIDAY Y N where PDATE gt Processing Date Specify the processing date in yymmdd format If omitted the CPU Date
237. the common A LOG database Fig 1 4 Multi CPU Job Log Management using JESMAS IBM A LOG User s Manual 1 7 Chapter 1 A LOG System Facilities OS Spool OS Spool OS Spool A LOG Database Share DASD A LOG System is installed in CPU 1 and CPU 3 The A LOG database can be shared by both CPUs Although not shown in above example A LOG System can also be installed in CPU 2 and share access to the common A LOG database Fig 1 5 Multi CPU Job Log Management using Multiple OS Spools 1 8 A LOG User s Manual Chapter 2 A LOG Master Management Facility A LOG Terminal Facility TSO TSS AS LP A LOG Database Job Log Master Job Log Index SYSLOG Master SYSLOG Index ALOGJLOG Utility ALOGJMST Utility ALOGSLOG Utility Chapter 2 A LOG Master Management Facility 2 1 Master Management Functions 2 1 1 Introduction A LOG System consists two master files 1 Job Log Master and 2 SYSLOG Master The operation information required by A LOG System for managing job logs are stored in Job Log Master The retention period and inquiry conditions of job logs and SYSOUTs may vary from job to job A LOG System uses the Job Log Master to store these attributes and to manage the changes to these attributes Similarly the operation information required by A LOG System for managing SYSLOGs are stored in SYSLOG Master The retention period and inquiry conditions of SYSLOGs may also vary from job to job A LOG
238. tings AR M DISP SHR Samples of Job Start Separator and SYSOUT Start Separator are shown on the following pages 11 76 A LOG User s Manual Chapter 11 A LOG System Utilities Job Start Separator SSSSSSS SS PPPPPPPPPP SSSSSSS SS MM MM ss SSS PP PP ss SSS MMM MMM SSS ss PP SSS ss MM M MMMM ss S PP PP ss S MM MMM MM PPPPPPPPP MM M MM PP MM MM S PP S MM MM ss PP ss MM MM SSS ss PP SSS ss MM MM S SSSSSSSS S SSSSSSSS MMMM MMMM JJJJJJJJJJ 00000000 BBBBBBBBBB 000000 111 3333333 111 88888888 000 000 BB BB 00 00 TUTUI 33 333 TUTL 88 88 000 000 BB 00 000 i Eee bal a 333 333 a Eager be BB 888 888 000 000 BB BB 000 0 000 1 111 33 333 1 111 88 88 000 000 BBBBBBBBB 000 o 000 111 333 111 88888888 000 000 BBBBBBBBB 000 0 000 TI 333 ILL 88888888 000 000 BB BB 000 O 000 111 33 333 111 88 88 000 000 BB BBB 000 00 111 333 333 111 888 888 000 000 BB BB 00 00 111 33 333 111 88 88 00000000 BBBBBBBBBB 000000 a Bes Boa Da Da Da Da Da Da E 3333333 111111111 88888888 CAT DATE 96 02 10 16 39 50 JOB NAME ASPASM JOB NUMBER JOB01318 START DA 96 02 10 16 39 38 END DATE 96 02 10 END TIME 16 39 43 COND COND 0000 JOB LOG COMMENT PRIN 96 02 10 12 08 30 A LOG User s Manual 11 77 Chapter 11 A LOG System Utilities Job Start Separator 000000 PLE 00 00 000 000 000 000 0 000 00 0 0 0 00 000 000 000 000 000 00 00 000000 1111 1 111 1 111
239. to job log after restoration because the After Restore Index Retention Period and After Restore Data Retention Period items become valid In this case a message NOT REFERRED is displayed RETENTION DAYS 4 Numeric Delete Retention Period is displayed This item may DELETE be modified by specifying a value between 0000 to 1830 This item is not applicable to job log after restoration because the After Restore Index Retention Period and After Restore Data Retention Period items become valid In this case a message NOT REFERRED is displayed CATLGSTARTDATE ob iog storage start date is displayed CATLGENDDATE ob iog storage end dae is displayed STARTTIME ob iog storage start time is displayed Enorme ob iog storage end time is displayed STATUS CATLG Job log storage status is displayed START Storage has started ABEND Storage has abended Storage has ended STATUS PLACE Storage location of job log data is displayed Not yet stored or deleted Stored in A LOG Data Pool DUMP MT Stored in Dumped MT DESTINATION CODE Destination code for the job log is displayed This item is treated as a comment in this version tem Length A LOG User s Manual 10 39 Chapter 10 A LOG Terminal Operations JOBLOG COMMENT 64 Alphanumeric Job log comment is displayed This item may be modified USER COMMENT Alphanumeric User comment is displayed This item may be modif
240. torage start date of the SYSLOG is displayed CPU date CATLG END DATE Storage end date of the SYSLOG is displayed CPU date START TIME Storage start time of the SYSLOG is displayed CPU time END TIME EAN Storage end time of the SYSLOG is displayed CPU time STATUS CATLG Storage status of SYSLOG is displayed START Storage has started ABEND Storage has abended END Storage has ended Length A LOG User s Manual 10 73 Chapter 10 A LOG Terminal Operations STATUS PLACE Storage location of SYSLOG data is displayed A Not yet stored or deleted BKS Stored in A LOG Data Pool DUMP MT Stored in Dumped MT DESTINATION CODE i ee Destination code for printing of SYSLOG is displayed SYSLOG COMMENT 64 Alphanumeric SYSLOG comment is displayed This item may be modified USER COMMENT Alphanumeric User comment is displayed This item may be modified DUMP DSNAME i AA Dataset name of Dump MT is displayed VOL SER RARR Volume serial number of Dump MT is displayed LABEL fe ee Label number of Dump MT is displayed RESTORE REQUEST Status of restore reservation is displayed A No request for restoration ON Restore reservation has been set OFF Restore reservation not set RESTORE STATUS Whether a reservation has been performed or not is displayed INDEX Index has been restored DATA Data has been restored INDEX DATA Both index and data have been restored If this item is blank Dump Retentio
241. umber END Storage Ended Job Log Storage Date ABEND Storage Abended Job Log Storage Time Number of Pages Job Name Starting Block Number lt gt Job Number Ending Block Number x Job Start Date Volume Serial Number of Dump MT Job Start Time Job Completion Code A LOG User s Manual 11 54 Chapter 11 A LOG System Utilities 11 15 ALOGLDMP Utility 11 15 1 Functional Overview ALOGLDMP utility is used to dump SYSLOGs that have exceeded the Dump Retention Period to a magnetic tape called Dump MT Both the SYSLOG index and data are dumped This utility provides the following functions 1 A processing date can be specified in the EXEC parameter as a criterion for selecting SYSLOGs to be dumped If it is not specified the current A LOG Operation Date is used as the processing date A SYSLOG will be dumped if it satisfies the following condition SYSLOG Storage Date Dump Retention Period lt Processing Date If the Dump Retention Period is 29 or less and reference to Holiday Master is specified in EXEC parameter the retention period is calculated using working days only However if the SYSLOG is stored on a holiday that day itself is counted as one retention day The following example shows the calculation of retention periods using working days for SYSLOGs A and B Holiday Master HH 22 A Dump Retention eee A Period 5 Dumpt Retention Period 5 _ Storage Date C Dump Rete
242. umped ALOGLDMP 1 9 utility will terminate when the total number of pages dumped reached the maximum number tl When both SYS and SID keywords are specified only SYSLOGs with the specified job name and job number will be dumped Keep Days is used as the Dump Retention Period only if it is greater than the Dump Retention Period of the SYSLOG Otherwise the Dump Retention Period of the SYSLOG is used The concept of RETN and KEEP is the same as that for ALOGJDMP utility For details please refer to that utility Example of Dump Parameter Card DUMP RID SYSLOG SYS SYSLOG1 SYSLOG2 RETN 3 2 Holiday Master Specification The required Holiday Master is specified in HOLTABLE DD statement as follows HOLTABLE DD DSN holiday master dataset name member name DISP SHR 11 58 A LOG User s Manual Chapter 11 A LOG System Utilities 3 EXEC Parameters ALOGLDMP DMPVOL volser PDATE yymmdd HOLIDAY Y N where DMPVOL gt Dump MT Volume Serial Number Specify the volume serial number of the Dump MT To change the dataset name of the Dump MT modify DDOUT DD statement of the JCL E PDATE gt Processing Date Specify the processing date in yymmdd format If omitted the current A LOG Operation Date is used HOLIDAY Holiday Master Reference Option Y Holiday Master is referenced N Do not reference Holiday Master Default 11 15 4 Output Listing A sample output listing of Dump MT Proof List
243. while loading screen module with menu number ERROR n n N INVALID JOBLOG ID An invalid job log or SYSLOG ID has been specified INVALID COPY JOBLOG ID An invalid job log or SYSLOG ID for copying has been specified 10 16 A LOG User s Manual Chapter 10 A LOG Terminal Operations 1 1 1 Job Log SYSLOG Master Directory Screen A LOG 1 1 1 JOB SYSLOG MASTER DIRECTRY INQ UPD 96 09 04 14 06 25 COMMAND gt JOB SYSLOG ID VALID DATE JOBLOG 700101 JOBLOG 900101 JOBLOG 990101 JOBLOG 000101 JOBLOG 351231 JOBLOG 691231 JOBLOGAA 700101 JOBLOGAB 800101 SYSLOG 700101 kkkkkkxk END OF DATA KKKKKKK Function This screen displays the Job Log or SYSLOG Master records satisfying the selection criteria specified in 1 0 0 Job Log SYSLOG Master Management screen It is used for the following operations e Selection of a master record for copying e Selection of master records for deletion e Selection of a master record for viewing or updating e Search for a job log or SYSLOG ID Screen Commands To switch to 0 0 0 Initial Menu screen ue Toser upone page IIA UP To delete job log and SYSLOG master records A LOG User s Manual 10 17 Chapter 10 A LOG Terminal Operations 10 18 F job log syslog id To search for a specific job log or SYSLOG ID in the directory listed on the screen Input Output Items Length 1 Alphabetic Specify one of the following operation codes S
244. wing operations e Scrolling of SYSLOG data e Searching for specific character strings e Displaying of SYSLOG data in HEX format e Displaying of SYSLOG data in CHAR format e Request for printing of SYSLOG data Screen Commands MENU To switch to 0 0 0 Initial Menu screen XEXIT To terminate A LOG Terminal Facility EXIT To switch to 3 1 0 SYSLOG Data Select screen HEX To display data in HEX mode A LOG User s Manual 10 59 Chapter 10 A LOG Terminal Operations 10 60 Lan Lon To display the line which is n tines Before the current line Cn To display SYSLOG data on current page starting from column n onwards C n To display SYSLOG data on current page starting from the column which is n columns after the current column C n To display SYSLOG data on current page starting from the column which is n columns before the current column To display SYSOUT dataset which is n datasets after the currently displayed SYSLOG data To display SYSOUT dataset which is n datasets before the currently displayed SYSLOG data PRINT To print the currently displayed SYSLOG data FIND To search for the specified character string continuously Input Output Items LINE 8 Numeric Display line number entered from previous screen will be each displayed This item may be modified PRINT MAX LINES Numeric Maximum line number entered from previous screen will be displayed This item may be modified COLUMN corum Start
245. x 3 2 1 Introduction 3 2 2 Job Attribute Information A job log index is created by ALOGJLOG utility whenever a job log is stored into A LOG database The creation of the job log index is based on master record defined in Job Log Master The Job Log Master record to be referenced is specified in the job definition card of ALOGJLOG utility Refer to 3 4 ALOGJLOG Utility for further details A job log index consists the following information e Job Attribute Information e SYSOUT Attribute Information A LOG Terminal Facility can be used to perform inquiry on job log indexes Job attribute information are displayed on A LOG 2 1 2 1 and A LOG 2 1 2 2 screens as follows A LOG 2 1 2 1 COMMAND gt JOB NAME JOB NO JOB START DATE START TIME COND CODE PAGE COUNT SYSOUT CLASS JOB CLASS RETENTION DAYS DUMP CATLG START DATE START TIME STATUS CATLG DESTINATION CODE JOBLOG COMMENT gt USER COMMENT gt iouou wou tou ou il LOG INDEX NO 1 V3 80ALOG STCO1482 960812 185724 0000 LOG JOB 000003 INQ UPD DATE JOBLOG ID END DATE END TIME LINE COUNT 1 DATASET COUNT J 0003 DEI 960812 CATI 194441 END LOCAL SYSLOG COMMENT USER COMMENT RETENTION DAYS LETE LG END DATE END TIME STATUS PLACE tou uw a 96 11 04 14 11 55 960812 JOBLOG 960812 190231 00000204 002 0003 960812 194454 DUMP MT Fig 3 2 Job Log Attribute Informatio
246. y 9 5 5 NATB Command Function To display the number of work areas and GETMAIN size made available to A LOG System Command Syntax F ALOG NATB Example Operator enter F ALOG NATB A LOG messages displayed on console SPM0111 OPERATOR TYPED IN NATB SPM122I NATB 005 CSA GETMAIN 025K S228 004K S241 021K ye Number of work areas made available to A LOG Monitor Based on this value the work area allocated for Subpool 241 is NATB value x 4K Total GETMAIN size in CSA Size of the work area allocated to Subpool 228 Size of the work area allocated to Subpool 241 A LOG User s Manual Chapter 9 A LOG Monitoring Facility 9 5 6 NJQE Command Function To display the total number of entries current number of unused entries and utilization rate in Job Log Queue Job Log Queue is an internal table used within A LOG Monitor for writing the contents of job log or SYSLOG indexes Command Syntax F ALOG NJQE Example Operator enter F ALOG NJQE A LOG messages displayed on console SPM0111 OPERATOR TYPED IN NJQE SPM120I NJQE 010000 FREE 009811 001 UTILIZATION te vx Total number of entries in Job Log Queue This number is specified in NJQE keyword of RUNSPM2 parameter For further details about RUNSPM2 parameter please refer to 6 2 Parameter Library of A LOG System Administrator s Manual Unused number of entries in Job Log Queue Utilization rate
247. y when ALOGRSEL utility is executed Note Only when the Storage Place of the SYSLOG data is in Dump MT the SYSLOG can be reserved for restoration Cancel Reservation for Restoration of SYSLOGs Required Item Specification Specify R for the SYSLOGs for which reservation for restoration are to be cancelled COMMAND Specify REST OFF command Specify the above and press ENTER key The Restore Reservation Flag for the SYSLOG will be set to OFF Search for Specific SYSLOG ID Required Item Specification COMMAND Specify F syslog id Specify the above and press ENTER key If the specified SYSLOG ID is found it will be displayed on the first line To continue searching for the next line with the same SYSLOG ID specify FIND command and press ENTER key A LOG User s Manual 10 69 Chapter 10 A LOG Terminal Operations Screen Messages CALLED SCREEN NOT FOUND The function associated with the specified menu number is not available INVALID COMMAND An invalid command has been specified n n n CALLED SCREEN LOAD ERROR An error has occurred while loading screen module with menu number n n n RESTORE COMMAND COMPLETE Processing for restore reservation for restore or cancellation of reservation for restore is completed DUMP MT VOL SER LABEL DSNAME Volume serial number label number and dataset name of UNMATCH ERROR Dump MT for a SYSLOG index specified for restoration does not match
248. ys 13 and 14 are not counted as retention days dotted lines However if the job log is stored on a holiday as in the case of job log C that day is counted as one retention day _Hicates the date on which the Dump Retention Period is expired A LOG User s Manual Chapter 11 A LOG System Utilities The circled number below the arrow indicates the number of days remaining before the retention period is expired Therefore when Processing Date 15 May and RETN 4 job logs A and C will be dumped but not job log B Example 2 KEEP 3 and reference to A AUTO Holiday Master specified Processing Date Holiday Master afaj fT es O Ei Storage Date Dumped HH Not dumped Retention Period 1 E Retention Period 1 F Retention Period 1 H Legend For all job logs in the example Keep Days is used in place of Dump Retention Period because it is the larger value The circled number in the diagram indicates the number of working days that the job log has been retained Holidays 13 and 14 are not counted as retention days dotted lines However if the job log is stored on a holiday as in the case of job log E that day is counted as one retention day Therefore when Processing Date 17 May and KEEP 3 job logs D and E will be dumped but not job log F 2 Holiday Master Specification The required Holiday Master is specified in HOLTABLE DD statement as f

Download Pdf Manuals

Related Search

2.0MB 2.0 mbps 2.0mb 2.0 mb to kb

2.0MB

Contents

Download Pdf Manuals

Related Search

Related Contents