Parameters passed to the exit program

The parameters that are passed to the exit program.

Log record

The log record is a log stream record or a service record which contains log stream block or copy log information. The copy log information records are passed to the precopy exit as the first and the last records. Additional records in the log stream copy describes the structure of this record.

If you do not specify the keyword OLD on the DEFEXIT statement, the structure of the log record depends on the value of the SELECT keyword on the LOGSTREAMCOPY command.

If the SELECT keyword specifies the value CICS® VR, the log stream copy utility passes a single general log stream record instead of a full logger block. The figure below shows the log records which are passed to the precopy exit when SELECT(CICSVR) is specified.

Figure 1. Records passed to the precopy exit when CICS VR is selected
1 CICSVR Copy log info record
	2 Log info record (LOGI DSECT)
1 First general log block
	2 Block header (LGBH_BLOCK_HEADER DSECT)
	2 Return block INFO area (IXGBRMLT_RETINFO DSECT)
	2 End marker, 17 characters: "0<<<LOGGERINFO>>>"
1 First CICS record in the block
	2 Record header (GLRH_RECORD_HEADER DSECT)
	2 Caller data(SOR/TIEUP/REDOS/...)
1 Next CICS record in the block
	2 ...
1 Last CICS record in the block
	2 ...
1 Next general log block
	2 ...
...
...
...
1 CICSVR End copy log info record
	2 Log info record (LOGI DSECT)

If the SELECT keyword specifies the value ALL, the log stream copy utility passes a full logger block. The figure below shows the log records which are passed to the precopy exit when SELECT(ALL) is specified.

Figure 2. Records passed to the precopy exit when ALL is selected
1 CICSVR Copy log info record
	2 Log info record (LOGI DSECT)
1 First general log block, prefixed with Return block information area
	2 Return block info area (IXGBRMLT_RETINFO DSECT)
	2 First general log block
		3 Block header (LGBH_BLOCK_HEADER)
		3 First CICS record in the block
			4 Record header (GLRH_RECORD_HEADER DSECT)
			4 Caller data(SOR/TIEUP/REDOS/...)
		3 Next CICS record in the block
			4 ...
		...
		3 Last CICS record in the block
			4 ...
1 Next general log block, prefixed with Return block information area
	2 ...
...
...
...
1 CICSVR End copy log info record
	2 Log info record (LOGI DSECT)

The sample precopy exit routine, which is the DWWXPREC member of the DWW.SDWWSORC data set, contains DSECTs that provide maps for log record headers and service log stream copy records.

The map of the record header that prefixes the general log stream record is provided in the GLRH_RECORD_HEADER DSECT of the DFHLGGFD macro.

Work area

A 128-byte work area that can be used to pass information between exit programs. See the description in Parameter lists.

Information Information

Feedback


Timestamp icon Last updated: Friday, 7 February 2014


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic///dwwig/dwwig000307.html