Appendix P. SMF Data Format

The following table defines the data that the platform server writes to SMF. The platform server writes the standard SMF 18-byte header and the following table defines the data after the header.

Note: The hexadecimal displacement and decimal displacement are relative to 0.
Hex Displ. Decimal Displ. Field Length Field Type Field Name Description
0 0 8 Binary QUEUE_BYTE_COUNT Number of bytes transferred
24 36 4 Binary QUEUE_CHECKPOINT_COUNT Number of checkpoints that have been taken
28 40 4 Binary QUEUE_CHECKPOINT_INERVAL Number of minutes between checkpoints
2C 44 4 Binary QUEUE_RECORD_COUNT Number of records transferred
44 68 1 Hex QUEUE_WAIT_FLAG

Wait Flag: initiators only

0x80: wait for transfer to complete

50 80 2 Binary QUEUE_TRY_COUNT Number of times the transfer has been attempted
52 84 2 Binary QUEUE_RETRY_MAX Maximum number of times a request can be tried
56 86 2 Binary QUEUE_LRECL MVS file LRECL
58 88 8 Char QUEUE_PROC Transfer process name
60 96 10 Char QUEUE_TRANSNUM Local transaction number
6D 109 8 Char\Hex QUEUE_REMOTE_SYS

QUEUE_IPADDR

QUEUE_NODENAME

Remote system information:
  • If 0xffffffffffffffff, this is an IP name.

    Wherein, QUEUE_IPNAME has bytes 1 - 24, and QUEUE_IPNAME2 has bytes 25 - 64

  • If 2nd 4 bytes = 0xffffffff, this is an IP address.

    Wherein, the first 4 bytes have IP address in hexadecimal.

  • Otherwise, this is a node name.

    Wherein, bytes 1 - 8 hold the node name, and QUEUE_NODENAME_EXT has bytes 9 - 32.

79 121 256 Char QUEUE_LOCAL_FILE z/OS local file name
17A 378 1 Char QUEUE_AFFECT Output file disposition
  • C: create
  • R: replace
  • A: append
  • X: create and replace
  • Y: create and append
  • Z: create and replace new
17B 379 25 Char QUEUE_USER_DATA User data associated with the transfer
194 404 1 Char QUEUE_TRANSFER_TYPE Type of transfer:
  • S: send
  • R: receive
  • U: submit
  • E: Rexx exec
  • I: script
195 405 8 Char QUEUE_LOCAL_USER Name of local MVS user
1B9 441 1 Char QUEUE_NOTIFY_USER_TYPE T: notify TSO user ID

R: notify Roscoe user ID

1BA 442 20 Char QUEUE_REMOTE_USER Name of remote user ID
1CE 462 7 Char QUEUE_DATE_ELIGIBLE Date transfer is eligible to run (YYYYDDD)
1D5 469 6 Char QUEUE_TIME_ELIGIBLE Time transfer is eligible to run (HHMM00)
1DB 475 7 Char QUEUE_DATE_STARTED Date transfer execution started (YYYYDDD)
1E2 482 6 Char QUEUE_TIME_STARTED Time transfer execution started (HHMM00)
1E8 488 7 Char QUEUE_DATE_INTRUP Date transfer completed (YYYYDDD)
1EF 495 6 Char QUEUE_TIME_INTRUP Time transfer completed (HHMM00)
1F5 501 7 Char QUEUE_DATE_EXPIRE Date when transfer will expire and be purged (YYYYDDD)
1FC 508 1 Hex QUEUE_EMAIL_FLAG Email notification flag
  • 0x80: email on successful transfer
  • 0x40: email on unsuccessful transfer
  • 0x08: MQ notify on successful transfer
  • 0x04: MQ notify on unsuccessful transfer
1FD 509 1 Char QUEUE_FTAM_DOC_TYPE Document type:
  • 1 or 0x01: text
  • Any other value: binary
204 516 1 Char QUEUE_RECFM File MVS record format:
  • X: RECFM=F
  • A: RECFM=FS
  • F: RECFM=FB
  • B: RECFM=FBS
  • Y: RECFM=V
  • W: RECFM=VS
  • V: RECFM=VB
  • Z: RECFM=VBS
  • U: RECFM=U
205 517 1 Char QUEUE_CHECKPOINT Checkpoint flag

Y: use checkpoints

20B 523 1 Char QUEUE_CRLF Record delimiters (ignored for z/OS to z/OS):
  • Y: records are CRLF delimited.
  • N: records have no delimiters.
  • L: records are LF delimited.
20F 527 3 Char QUEUE_VERSION Version of local platform server system (VRM)
212 530 1 Char QUEUE_TRANSFER_WORK Type of file transfer:
  • F: file to file
  • P: file to print
  • J: file to job
  • C: send command
250 592 120 Char QUEUE_LAST_MSG Last message issued regarding the transfer
340 832 256 Char QUEUE_REMOTE_FILE Name of remote file
448 1096 64 Char QUEUE_EMAIL_GOOD Email address for successful notification
4C8 1224 64 Char QUEUE_EMAIL_FAIL Email address for unsuccessful notification
4CC 1228 6 Char QUEUE_VOLSER MVS volser for output file
4D3 1235 1 Hex QUEUE_INITIATION_FLAGS Flag that defines how transfer was initiated:
  • 0x80 bit: transfer is initiator
  • 0x40 bit: transfer is responder
4E0 1248 10 Char QUEUE_REMOTE_TRANSNUM Remote transaction number
4EA 1258 4 Binary QUEUE_ALLOC_PRI Primary file allocation
4EE 1262 4 Binary QUEUE_ALLOC_SEC Secondary file allocation
4F2 1266 1 Hex QUEUE_COMPRESSION Compression flag:
  • 0x11: LZ compression
  • 0x12: RLE compression
  • 0x14: ZLIB compression (See QUEUE_ZLIB_TYPE)
4F3 1267 1 Hex QUEUE_ENCRYPT_FLAG Encryption flag (bit settings):
  • 0x80: no encryption
  • 0x40: DES
  • 0x20: 3DES
  • 0x10: Blowfish
  • 0x08: Blowfish long (448 bit)
  • 0x04: AES (for example, AES) 256 bit
4F4 1268 1 Hex QUEUE_SSL_FLAG SSL flag:
  • 0x80: SSL is on.
  • Any other value: SSL is off.
538 1336 8 Binary QUEUE_COMPRESS_BYTES Number of compressed bytes sent
545 1349 16 Char QUEUE_DOMAIN_NAME Windows domain name
555 1365 14 Char QUEUE_IPNAME

QUEUE_NODENAME_EXT

Either IP name or node name. See QUEUE_REMOTE_SYSfield (0x6D)
56D 1389 1 Char QUEUE_ERROR_TYPE Type of error that occurred:
  • L: local
  • R: remote
  • N: network
56E 1390 2 Binary QUEUE_IPPORT IP port associated with initiator requests
58C 1420 4 Binary QUEUE_ALLOC_DIR PDS directory block allocation
590 1424 2 Binary QUEUE_MEMBER_COUNT Count of members transferred (z/OS to z/OS only)
597 1431 1 Hex QUEUE_RETURN_CODE Transfer return code:
  • 0: transfer succeeds.
  • <> 0: transfer fails.
598 1432 8 Char QUEUE_DSN_UNIT Unit name for output file
5A0 1440 8 Char QUEUE_DATACLASS SMS data class for this transfer
5A8 1448 8 Char QUEUE_MGMTCLASS SMS management class for this transfer
5B0 1456 8 Char QUEUE_STORAGECLASS SMS storage class for this transfer
5B8 1464 8 Char QUEUE_JOBID The JES job ID when the transfer type is JOB.
5C0 1472 1 Char QUEUE_ALLOC_TYPE Allocation type:
  • C: cylinders
  • T: tracks
  • B: blocks
  • K: kilobytes
  • M: megabytes
5C8 1480 2 Binary QUEUE_BLKSIZE The MVS block size of a file
562 1506 1 Hex QUEUE_LDISP_DISP Local file status:
  • 0x80: DISP=SHR
  • 0x40: DISP=MOD
  • 0x20: DISP=OLD
  • 0x10: DISP=NEW
  • 0x30: DISP=NEWR
  • 0x50: DISP=NEWA
  • 0x31: DISP=NEWN
5E3 1507 1 Hex QUEUE_LDISP_STATUS Local file normal, failure disposition:
  • 0x80: DISP=(,KEEP), normal disposition
  • 0x40: DISP=(,CATLG)
  • 0x20: DISP=(,DELETE), failure disposition
  • 0x08: DISP=(,,KEEP)
  • 0x04: DISP=(,,CATLG)
  • 0x02: DISP=(,,DELETE)
5E4 1508 1 Hex QUEUE_RDISP_DISP Remote file status:
  • 0x80: DISP=SHR
  • 0x40: DISP=MOD
  • 0x20: DISP=OLD
  • 0x10: DISP=NEW
  • 0x30: DISP=NEWR
  • 0x50: DISP=NEWA
  • 0x31: DISP=NEWN
5E5 1509 1 Hex QUEUE_RDISP_STATUS Remote file normal, failure disposition:
  • 0x80: DISP=(,KEEP), normal disposition
  • 0x40 DISP=(,CATLG)
  • 0x20 DISP=(,DELETE)
  • 0x08 DISP=(,,KEEP), failure disposition
  • 0x04 DISP=(,,CATLG)
  • 0x02 DISP=(,,DELETE)
5E8 1512 1 Char QUEUE_COMMAND_TYPE Command type (for TRANS_TYPE=COMMAND):
  • C: command
  • R: REXX eXEC
  • J: CALLJCL
  • P: CALLPGM
  • J: submit job
5FA 1530 6 Char QUEUE_IVOLUME Input volume for uncataloged input files
600 1536 3 Char QUEUE_UNIX_FILE_PERMISSIONS UNIX permissions:
  • Byte 1: user permissions (0 - 7)
  • Byte 2: group permissions (0 - 7)
  • Byte 3: other permissions (0-7)
606 1542 1 Char QUEUE_VSAM_FILE_TYPE VSAM file type:
  • K: KSDS
  • E: ESDS
  • R: RRDS
60D 1549 44 Char QUEUE_DCB_LIKE

QUEUE_VSAM_LIKE

Model file for sequential or VSAM files
63A 1594 1 Hex QUEUE_ACTION_FLAG1 Post processing action flag 1:
  • 0x80: success
  • 0x40: initiator
63B 1595 1 Hex QUEUE_ACTION_TYPE1 Post processing action type 1:
  • 0x01: CALLPGM
  • 0x02: COMMAND
  • 0x03: CALLJCL
  • 0x04: SUBMIT
63C 1596 64 Char QUEUE_ACTION_DATA1 Post processing action data 1

See QUEUE_ACTION_DATA1_EXT for additional 192 bytes.

67C 1660 1 Hex QUEUE_ACTION_FLAG2 Post processing action flag 2:
  • 0x80: success
  • 0x40: initiator
67D 1661 1 Hex QUEUE_ACTION_TYPE2 Post processing action type 2:
  • 0x01: CALLPGM
  • 0x02: COMMAND
  • 0x03: CALLJCL
  • 0x04: SUBMIT
67E 1662 4 Char QUEUE_ACTION_DATA2 Post processing action data 2

See QUEUE_ACTION_DATA1_EXT for additional 192 bytes.

6BE 1726 1 Hex QUEUE_ACTION_FLAG3 Post processing action flag 3:
  • 0x80: success
  • 0x40: initiator
6BF 1727 1 Hex QUEUE_ACTION_TYPE3 Post processing action type 3:
  • 0x01: CALLPGM
  • 0x02: COMMAND
  • 0x03: CALLJCL
  • 0x04: SUBMIT
6C0 1728 64 Char QUEUE_ACTION_DATA3 Post processing action data 3

See QUEUE_ACTION_DATA1_EXT for additional 192 bytes.

700 1792 1 Hex QUEUE_ACTION_FLAG4 Post processing action flag 4:
  • 0x80: success
  • 0x40: initiator
701 1793 1 Hex QUEUE_ACTION_TYPE4 Post processing action type 4:
  • 0x01: CALLPGM
  • 0x02: COMMAND
  • 0x03: CALLJCL
  • 0x04: SUBMIT
702 1794 64 Char QUEUE_ACTION_DATA4 Post processing action data 4

See QUEUE_ACTION_DATA1_EXT for additional 192 bytes.

742 1858 4 Binary QUEUE_ACTION_RETCODE1 Post processing return code 1
746 1862 4 Binary QUEUE_ACTION_RETCODE2 Post processing return code 2
74A 1866 4 Binary QUEUE_ACTION_RETCODE3 Post processing return code 3
74E 1870 4 Binary QUEUE_ACTION_RETCODE4 Post processing return code 4
764 1892 16 Char QUEUE_LOCAL_CONVTBL_FILE Local conversion table file name
774 1908 16 Char QUEUE_REMOTE_CONVTBL_FILE Remote conversion table file name
791 1937 1 Char QUEUE_ZLIB_TYPE ZLIB compression type (1 - 9)

See QUEUE_COMPRESSfor details.

79C 1948 40 Char QUEUE_IPNAME2 IP name extension

See QUEUE_REMOTE_SYS for details.

7C4 1988 8 Char QUEUE_IUNIT Input file unit name
7CC 1996 4 Binary QUEUE_MQ_WAIT_INTERVAL Interval waited before EOF on MQ transfer
800 2048 192 Char QUEUE_ACTION_DATA1_EXT PPA Data1 extension
8C0 2240 192 Char QUEUE_ACTION_DATA2_EXT PPA Data2 extension
980 2432 192 Char QUEUE_ACTION_DATA3_EXT PPA Data3 extension
A40 2624 192 Char QUEUE_ACTION_DATA4_EXT PPA Data4 extension
B00 2816 64 Char QUEUE_RSHOST RocketStream host name
B40 2880 4 Binary QUEUE_RSMAXSPEED RocketStream maximum speed (0 = unlimited)
B44 2884 2 Binary QUEUE_RSPORT RocketStream IP port number
B46 2886 1 Hex QUEUE_RSFLAG RocketStream Acceleration flag:
  • 0x80: use RocketStream Accelerator
  • Any other value: do not use RocketStream
B47 2887 1 Hex QUEUE_RSPROTOCOL RocketStream protocol:
  • 0x00: TCP
  • 0x01: UDP
  • 0x02: PDP
B48 2888 1 Hex QUEUE_RSENCRYPT RocketStream encryption:
  • 0x00: no encryption
  • 0x01: Blowfish 256 encryption
B49 2889 1 Hex QUEUE_RSCOMPRESS RocketStream compression:
  • 0x00: no compression
  • 0x01: use the best compression
  • 0x02: use the default compression
  • 0x03: use the fastest compression