Print audit trail screen (online conversation)
The Print Audit Trail screen is used to print the contents of the audit trail that you created using Option 2, or the File-AID for IMS/FLEX option, to edit a database. This screen is displayed when you select the sub-option from the Print Selection Menu.
Print Audit Trail screen
COMMAND ===>
Audit trail disposition . . . PD (PK = Print dataset and keep
PD = Print dataset and delete)
Audit trail dataset . . . . .
-------------------------------------------------------------------------------
Specify batch JCL information:
Sysout class . . *
Print format . . F (F = Formatted; H = Hexadecimal)
Print only changed fields . . N (Y = Yes; N = No)
JOB statement information:
> //TSOID01 JOB (XXXXXXX),'FILE-AID PRINT',
> // MSGCLASS=A,NOTIFY=TSOID01
> //
> //
Enter JCL command to edit generated JCL
Press ENTER to submit batch job
Audit Trail Disposition
Enter PK if you want to print and keep the audit trail. Enter PD if you want to print and delete the audit trail.
Audit Trail Dataset
Enter the dataset name of the audit trail you want printed. This data set could have been created by File-AID for IMS/ISPF directly or manually by the user from the system SMF log file. See Retrieving Audit Trail from SMF.
Sysout Class
Enter the output class that you want the Audit Trail Report written to.
Print Format
Indicate whether you want the Audit Trail Report printed in a formatted or hexadecimal mode.
F | In formatted mode, the database segment images contained in the audit trail are printed using COBOL or PL/I segment layouts, in a manner similar to the edit formatted sub-option. |
H | In hexadecimal mode, the segment images are printed in a three-line hexadecimal format, similar to HEX mode of the edit unformatted sub-option. |
Print Only Changed Fields
Indicate how you want File-AID for IMS to print the before and after images of changed segments on the Audit Trail Report.
Y | Only the fields that you changed are printed. Unchanged fields are excluded from printing. |
N | All fields in changed segments are printed. However, your entry does not affect the printing of inserted, repeated, and deleted segment images (that is, all fields are printed). |
Job Statement Information
Enter the JOB statement JCL for the batch print job.
Terminating the Screen
Do the following to terminate the Print Audit Trail screen:
- Press Enter to generate the JCL and submit the print job for execution.
- Enter the JCL command to proceed to an ISPF/PDF Edit screen (ISPF/PDF Edit Screen), where you can edit the generated JCL before submitting it.
- Enter the END, RETURN, or a jump command to leave this screen without submitting the batch print job.
Editing the Generated JCL
If you enter the JCL command on the Print Audit Trail screen, an ISPF/PDF Edit screen similar to the one shown in the following figure is displayed.
ISPF/PDF Edit Screen
COMMAND ===> SCROLL ===>
****** ******************************** TOP OF DATA ****************************
000001 //ATRPT JOB (XEQ,CWX),’ACCT1’,CLASS=E,PRTY=8
000002 /*ROUTE XEQ LOCAL
000003 /*ROUTE OUTPUT LOCAL
000004 //*
=NOTE= YOU ARE NOW EDITING THE JCL THAT FILE-AID HAS GENERATED TO PERFORM
=NOTE= THE REQUIRED FUNCTION. YOU CAN CHANGE THIS JCL IF DESIRED, AND USE
=NOTE= THE SUBMIT PRIMARY COMMAND TO SUBMIT THE JOB. TO KEEP THIS JCL FOR
=NOTE= FUTURE USE, USE THE CREATE OR REPLACE PRIMARY COMMAND. ENTER THE
=NOTE= END COMMAND TO EXIT THE FUNCTION WITHOUT SUBMITTING THE JOB.
000005 //*----------------------------------------------------------------*
000006 //* FILE-AID FOR IMS/ISPF AUDIT TRAIL REPORT: *
000007 //* THIS STEP PRODUCES AN AUDIT TRAIL REPORT FROM AN AUDIT *
000008 //* TRAIL DATASET CREATED DURING AN FILE-AID FOR IMS/ISPF *
000009 //* USER DATA BASE EDIT SESSION *
000010 //*----------------------------------------------------------------*
000011 //ATRPT EXEC PGM=XIXATRPI,REGION=1024K,PARM=’/NNF603’
000012 //STEPLIB DD DSN=hlq.CXVJLOAD,DISP=SHR custom File-AID load lib
000013 // DD DSN=hlq.SXVJLOAD,DISP=SHR File-AID load lib
000014 //* DD DSN=XXXXXXX.PANVALET.LOAD,DISP=SHR PANVALET load lib
000015 //* DD DSN=XXXXXXX.LIBARIAN.LOAD,DISP=SHR LIBRARIAN load lib
000016 //IXPMLIB DD DSN=hlq.SXVJMENU, DISP=SHR File-AID MSG lib
At this point, the ISPF/PDF editor has been invoked on the temporary data set that contains the JCL generated to produce the Audit Trail Report. All ISPF Edit commands are available for use. For example, to insert additional JCL statements, use the I (Insert) line command. To change the JCL, type over the data. To delete a line, use the D (Delete) line command. You can use the CREATE and REPLACE primary commands to save the generated JCL into a partitioned (PDS) or sequential dataset, which enables you to submit the JCL without using the online Print Audit Trail screen.
When you want to concatenate multiple audit trail datasets to produce a separate Audit Trail Report for each data set with one batch job execution is an example of when you need to edit the generated JCL before submitting the batch print job.
Do the following after you view or edit the JCL:
- Enter the SUBMIT command to submit the Audit Trail Report job for execution. The Audit Trail Report described on here is generated.
- Enter the END or CANCEL command to return to the Print Audit Trail screen.