IAMJUTIL—DUMP command
[ALL] [,BLOCKS]
[,COUNT=999999] [,DSN=dsn]
[,EMPTYOK] [,FROMBLOCKID=nnnnnnnn]
[,FROMBLOCKNO=nnnnnn] [,FROMDATE=yyyyddd]
[,FROMTIME=hhmmssth] [,FROMTTR=ttttttrr]
[,GENERICKEY] [,HEADERONLY]
[,JLOG] [,JOBID=cccccccc]
[,JOBNAME=cccccccc] [,JOURNAL=dsn]
[,KEY1=xxxxxxxx] .......[,KEY8=xxxxxxxx]
[,LOGSTREAMNAME=streamname] [,RLSID=cccc]
[,ROUTER=cccc] [,STEPNAME=cccccccc]
[.TARGET=cccc] [,TOBLOCKID=nnnnnnnnnnnn]
[,TOBLOCKNO=nnnnnn] [,TODATE=yyyyddd]
[,TOTIME=hhmmssth] [,TRANID=cccc]
[,TRANNO=nnnnn] [,TYPE=type]
The following table describes the DUMP command operands. All operands are optional unless indicated otherwise.
Operand | Description |
|---|---|
ALL | Dumps the entire content of each journal record, including the header information and the actual data record By default, only the data portion is printed. |
BLOCKS | Dumps the journal data set by block, not by records By default, every journal record is dumped. |
COUNT= | Dumps only the specified number of records. By default, all journal records are eligible for dumping. |
DSN= | Dumps only those journal records for the specified IAM data set from an IAM RLS journal. By default, the journal records for all of the IAM data sets are dumped. |
EMPTYOK | Sets the return code to 0 even if no records were dumped because of an empty journal. |
FROMBLOCKID= | Dumps journal records from the specified MVS system logger data set, starting with the specified block ID number. By default, start with the first record in the MVS system logger. |
FROMBLOCKNO= | Dumps the journal records from a sequential IAM journal file, starting from the specified relative block number. By default, start with the first block in the input journal file. |
FROMDATE= | Dumps records starting with those with the Julian date specified in the format yyyyddd. By default, the dump begins with the first record in the journal file, regardless of the date. |
FROMTIME= | Dumps records starting with those with the time specified time in the format hhmmssth. By default, the dump begins with the first record in the journal file, regardless of the time. |
FROMTTR=ttttttrr | Dumps Indicates that only journal records with the specified relative track address (TTR) or greater. You can obtain the TTR value from IAMJUTIL SCAN or DUMP output. The input value is hexadecimal digits with up to six digits for the track and two digits for the record number field. |
GENERICKEY | |
HEADERONLY | Dumps only the header portion of each journal record. By default, IAMJUTIL dumps only the data portion of each journal record. |
JLOG | Produces a printed log of all activity performed by the dump command. By default, a detailed log is not produced. |
JOBID= | Dumps records for the specified JES JOBID (usually JOBnnnnn or Jnnnnnnn). By default, records for all jobs are eligible for dumping. |
JOBNAME= | Dumps only the journal records that have a matching job name. If multiple jobs with the same name are encountered, then all of the jobs with a matching name are dumped unless restricted by other operands. By default, journal records for all jobs are eligible for dumping. |
JOURNAL=dataSetName | Specifies the data set name of the journal file to be used during the DUMP request. This is required if the journal is currently active by IAM/RLS or IAM/PLEX and cannot be specified in JCL, causing the job to wait for the specified journal to be free. |
KEY1=xxxxxxxx . | Enter up to 512 hexadecimal digits to create a key of up to 256 byte to be used during the dump. Each KEYx keyword can hold up to 64 hexadecimal characters which are converted to 32 bytes. All entered values are combined to make a single key or generic key to use during the DUMP. |
LOGSTREAMNAME= | Specifies the name of the MVS system logger data set from which IAMJUTIL dumps records. This keyword is required when processing an IAM RLS system logger journal data set. By default, IAMJUTIL assumes that the dump is from a sequential journal data set. |
RLSID=cccc | Dumps only journal records with the specified IAM RLSID. |
ROUTER=cccc | (Required) Selects journal records based on the RLSID of the ROUTER IAM/PLEX region. By default, the ROUTER RLSID is not used during record selection. |
STEPNAME= | Dumps only those records with the specified step name. By default, journal records are eligible for dump regardless of the step name. |
TARGET=cccc | Dumps only journal records with the specified IAM/PLEX TARGET RLSID. By default, the TARGET RLSID is not used during record selection. |
TOBLOCKID= | Specifies that IAMJUTIL should dump only data only up to and including the specified MVS system logger record ID. By default, dumping ends with the last record that is currently in the MVS system logger data set. |
TOBLOCKNO= | Dumps from a sequential IAM journal all data contained in the blocks up to and including the specified relative block number. By default, dumping ends with the last record in the sequential journal data set. |
TODATE= | Dumps all journal records up to and including the Julian date specified in the format yyyyddd By default, dumping ends with the last record found in the input journal data sets. |
TOTIME= | Dumps all journal records up to and including the time specified in the format of hhmmssth. By default, dumping ends with the last record found in the input journal data sets. |
TRANID= | Dumps only those records from an IAM RLS journal for the specified CICS transaction name. TRANID specifies one-to four-character transaction name. By default, all transactions are eligible for dump. |
TRANNO= | Dumps only those records with the specified one-to-five digit CICS transaction number By default, all transactions are eligible for dumping. |
TYPE= | Specifies that only journal records of the specified type should be included in the DUMP You can specify one of the following values: GETUPD, PUTUPD, PUTADD, DELETE, SYNC, CLOSE, STEPTERM, or RLS By default, all types are dumped. |
The following example prints the DUMP command for records for the specified job step (EX4804A):
//SYSUDUMP DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//IAMJRNL DD DISP=SHR,DSN=GFM.LOGDSN2.JOURNAL
//SYSOUT DD SYSOUT=*
//SYSIN DD *
DUMP ALL,JOB=jobname,STEP=stepname,JOBID=JOBnnnnn
/*