This section shows the JCL, IDSYSFT, and CICS table entries that the CA Ideal trace facility requires. All of the statements and entries required to run the traces are provided as part of the installation process. You can modify them, but if you change them, they must still include all required entries.
A z/OS job stream to trace a program includes:
//jobname JOB acctinfo,'username',MSGLEVEL=1 // EXEC IDBATCH //SYSIN DD * . . . CA Ideal trace commands and CA Ideal commands . . .
A standard JOB card containing information about the job for the operating system.
Identifies a JCL procedure containing the CA Ideal JCL procedure and the dataview records necessary for a batch session. IDLBTCH is the name of the PROC as installed. See your CA Ideal Administrator for a possible different name.
Indicates that the CA Ideal commands to executed follow. The CA Ideal commands are entered in a sequence that simulates an online session (for example, a SIGNON command is the initial command that simulates the signon screen and OFF is the final command).
The following standard JCL records are used in a VSE environment to execute CA Ideal traces in batch.
* $$ JOB JNM=IDBATCH,PRI=n,USER='username',DISP=D * $$ LST DISP=D,CLASS=L // JOB IDBATCH IDEAL // OPTION LOG,NODUMP // EXEC PROC=IDLPROC // EXEC IDBATCH,SIZE=15K . . . CA Ideal trace commands and CA Ideal commands here . . . /* // EXEC LISTLOG /* /& * $$ EOJ
Identifies job and user, and sets the job's priority, class, and disposition.
This jobstream is identified to POWER as 'IDBATCH'
Specifies the dispatching priority of this job is n.
Specifies the following the user name for accounting purposes:
Defines which VSE partition this jobstream can execute in.
Defines the disposition in the reader spool for the jobstream. D indicates that the jobstream should be submitted for execution immediately and not be retained in the reader queue (spool) after execution.
Defines the output parameters for the VSE system log file.
Defines the disposition of the output in the POWER list queue. As in the DISP option for the JOB command, D indicates that the jobstream should be released immediately and not retained in the queue.
Organizes the LIST queue. It is used with subsequent * $$ LST cards to logically separate the various CA Ideal outputs.
This is the first VSE job control command of the jobstream. The jobstream is identified as IDBATCH. All references to the JOB on the operator's console are to IDBATCH (not the POWER jobname).
This statement copies a JCL procedure into the jobstream. IDLPROC is an installed procedure to define all CA Ideal and user system files for batch.
IDBATCH is the CA Ideal batch processing program. The size parameter sets the amount of storage allocated to the program for execution. The rest of the partition is used for processing other CA Ideal routines. The statements that follow are CA Ideal commands, including trace commands. They are entered in a sequence that simulates an online session (for example, a SIGNON command is the initial command that simulates the signon screen and OFF is the final command).
/* JOB
Step delimiter.
LISTLOG is a VSE utility that adds all operator console messages associated with the jobstream to the end of the output for the jobstream.
VSE job delimiter.
POWER job delimiter.
The following DD statements, installed in the IDLBATCH procedure, are required to run the traces in batch.
//ADRTRC DD DSN=&&ADRTRC,DISP=(MOD,PASS), // UNIT=SYSDA,SPACE=(TRK,(15,15)), // DCB=BLKSIZE=2000 //SYSDIAL DD SYSOUT=* For DIAL-Only and ADPOBJ output. //AUXPRINT DD SYSOUT=* For VPE Trace file output
Defining ADRTRC as a temporary data set is suggested. If, however, the trace runs online but prints with CA Ideal Batch, the ADRTRC DD name must point to the same DSN as in the CICS start‑up JCL. Do not change the block size for the ADRTRC file.
The following ROSFD entries, installed in the IDSYSFT (CA Ideal System File Table) are required to run traces in batch.
SYSDIAL ROSFD DDNAME=SYSDIAL,ACCMETH=SEQ,RECFM=FBA, X
LRECL=133,BLKSIZE=1330,PRODUCT=IGN
AUXPRINT ROSFD DDNAME=AUXPRINT,ACCMETH=SEQ,RECFM=FBM, X
LRECL=133,BLKSIZE=1330,PRODUCT=IGN
ADRT ROSFD DDNAME=ADRTRC,ACCMETH=SEQ,RECFM=FB, X
LRECL=2000,BLKSIZE=2000,PRODUCT=IGN
Note: The IDSYSFT must be reassembled if any entries are added or changed. For more information, see the Installation Guide.
The following JCL, installed in the IDLPROC procedure, is required to run the traces in batch.
// DLBL ADRTRC,'file-id' // EXTENT SYSnnn,VOLID,,,beg-track,#-of-tracks // ASSGN SYSnnn, DISK,VOL=xxxxxx,SHR // ASSGN SYSLST,PRINTER For DIAL-Only and ADPOBJ output // ASSGN SYSaaa,PRINTER CA Ideal REPORT FORM #01 // ASSGN SYSbbb,PRINTER CA Ideal REPORT FORM #02 // ASSGN SYSccc,PRINTER CA Ideal REPORT FORM #03 // ASSGN SYSddd,PRINTER CA Ideal REPORT FORM #04 // ASSGN SYSeee,PRINTER CA Ideal REPORT FORM #05
SYSLST is used for DIAL‑Only and ADPOBJ output.
The SYS numbers assigned to the printers (SYSaaa‑eee) depend on the values assigned by the site at installation. System printers are used for VPE trace file output. Output goes to the device specified by the first available PSSPRTnn entry encountered in the IDSYSFT.
The following ROSFD entries installed in the IDSYSFT (CA Ideal System File Table) are required to run traces in batch:
SYSDIAL ROSFD ACCMETH=SEQ,DTFTYPE=DTFPR, X
DEVADDR=SYSLST,DEVICE=1403, X
CTLCHR=ASA,RECFM=F, X
BLKSIZE=133,OPSYS=DOS
ADRT ROSFD ACCMETH=SEQ,DTFTYPE=DTFSD, X
DEVADDR=SYSnnn,DEVICE=3340, X
DTFNAME=ADRTRC,RECFM=FB, X
IBLKSZ=2000,OBLKSZ=2008, X
LRECL=2000,OPSYS=DOS
PSSPRT01 ROSFD ACCMETH=SEQ,DTFTYPE=DTFPR, X
DEVADDR=SYSaaa,DEVICE=1403, X
CTLCHR=YES,RECFM=F, X
BLKSIZE=133,OPSYS=DOS
PSSPRT02 ROSFD ACCMETH=SEQ,DTFTYPE=DTFPR, X
DEVADDR=SYSbbb,DEVICE=1403, X
CTLCHR=YES,RECFM=F, X
BLKSIZE=133,OPSYS=DOS
PSSPRT03 ROSFD ACCMETH=SEQ,DTFTYPE=DTFPR, X
DEVADDR=SYSccc,DEVICE=1403, X
CTLCHR=YES,RECFM=F, X
BLKSIZE=133,OPSYS=DOS
PSSPRT04 ROSFD ACCMETH=SEQ,DTFTYPE=DTFPR, X
DEVADDR=SYSddd,DEVICE=1403, X
CTLCHR=YES,RECFM=F, X
BLKSIZE=133,OPSYS=DOS
PSSPRT05 ROSFD ACCMETH=SEQ,DTFTYPE=DTFPR, X
DEVADDR=SYSeee,DEVICE=1403, X
CTLCHR=YES,RECFM=F, X
BLKSIZE=133,OPSYS=DOS
Do not change the block size for the ADRTRC file. The IDSYSFT must be updated and reassembled if any entries are added or changed. See the Installation Guide.
The following DD statements are required as part of the CICS start‑up JCL to run CA Ideal traces online.
//ADRTRC DD DSN=index.Ideal.TRACE,DISP=SHR For Writing //ADRINT DD DSN=index.Ideal.TRACE,DISP=SHR For Reading
The following CICS DFHFCT entry is required:
DFHFCT TYPE=DATASET, X
DATASET=ADRINT, X
ACCMETH=BDAM, X
SERVREQ=GET, X
RELTYPE=BLK, X
LRECL=2000, X
BLKSIZE=2000, X
RECFORM=(FIXED,UNBLOCKED), X
OPEN=INITIAL
Note: An FCT entry is not needed for ADRTRC.
The TDQueue ADRT must be defined.
CEDA View TDqueue( ADRT ) TDqueue : ADRT Group : SIB0GRP DEscription : VPE TRACE TYPE : Extra Extra | INTra | INDirect EXTRA PARTITION PARAMETERS DAtabuffers : 001 1-255 DDname : ADRTRC DSname : Sysoutclass : Erroroption : Ignore Ignore | Skip Opentime : Initial Initial | Deferred REWind : Leave | Reread TYPEFile : Output Input | Output | Rdback RECORDSize : 02000 0-32767 BLOCKSize : 0-32767 RECORDFormat : Fixed Fixed | Variable BLOCKFormat : Unblocked Blocked | Unblocked Printcontrol : A | M DIsposition : Shr Shr | Old | Mod INTRA PARTITION PARAMETERS Atifacility : Terminal | File | System RECOVstatus : No | Physical | Logical Facilityid : TRAnsid : TRIggerlevel : 0-32767 Userid : INDOUBT ATTRIBUTES WAIT : No | Yes WAITAction : Queue | Reject INDIRECT PARAMETERS Indirectname : REMOTE PARAMETERS REMOTEName : REMOTESystem : REMOTELength : 0-32767
Note: A TDQueue definition is not needed for ADRINT. Do not change the block size for the ADRTRC file.
In the VSE environment, the VPE trace file that CICS online uses can remain closed even after CICS is brought up. In this case, it must be explicitly opened and enabled with the CICS Master Terminal Operator command:
CEMT SET QUEUE(ADRT) OPEN ENABLE
Although you can create a trace online, it can be extracted using Batch CA Ideal only. Online, the DLBL file name must be ADRTRC. The file ID, EXTENT, and ASSGN must match the corresponding entries for the batch DLBL definition of ADRTRC. That is:
// DLBL ADRTRC,'file-id' // EXTENT SYSnnn,VOLID,,,beg-track,#-of-tracks // ASSGN SYSnnn,DISK,VOL=xxxxxx,SHR
The TDqueue definition for VSE is the same as that for z/OS mentioned in the previous section.
|
Copyright © 2015 CA Technologies.
All rights reserved.
|
|