Appendix Q. 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. An assembler macro that defines this work area is located in: FUSION.SAMPLIB(OSIQUEUE)

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_SYS field (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 Postprocessing action flag 1:
  • 0x80: success
  • 0x40: initiator
63B 1595 1 Hex QUEUE_ACTION_TYPE1 Postprocessing action type 1:
  • 0x01: CALLPGM
  • 0x02: COMMAND
  • 0x03: CALLJCL
  • 0x04: SUBMIT
63C 1596 64 Char QUEUE_ACTION_DATA1 Postprocessing action data 1

See QUEUE_ACTION_DATA1_EXT for additional 192 bytes.

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

See QUEUE_ACTION_DATA1_EXT for additional 192 bytes.

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

See QUEUE_ACTION_DATA1_EXT for additional 192 bytes.

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

See QUEUE_ACTION_DATA1_EXT for additional 192 bytes.

742 1858 4 Binary QUEUE_ACTION_RETCODE1 Postprocessing return code 1
746 1862 4 Binary QUEUE_ACTION_RETCODE2 Postprocessing return code 2
74A 1866 4 Binary QUEUE_ACTION_RETCODE3 Postprocessing return code 3
74E 1870 4 Binary QUEUE_ACTION_RETCODE4 Postprocessing 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_COMPRESS for 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
000B4A 2890 6 Char QUEUE_OUTPUT_TAPE_VOL1 Output volume #1
000B50 2896 6 Char QUEUE_OUTPUT_TAPE_VOL2 Output volume #2
000B56 2902 6 Char QUEUE_OUTPUT_TAPE_VOL3 Output volume #3
000B5C 2908 6 Char QUEUE_OUTPUT_TAPE_VOL4 Output volume #4
000B62 2914 6 Char QUEUE_OUTPUT_TAPE_VOL5 Output volume #5
000B68 2920 4 Binary QUEUE_BLKSIZE_LBI LBI block size
000BBC 3004 2 Binary QUEUE_LOCAL_LABEL_SEQ Local label seq #
000BBE 3006 2 Binary QUEUE_REMOTE_LABEL_SEQ Remote label seq #
000BC0 3008 1 Hex QUEUE_LOCAL_LABEL_TYPE Local label type
000BC1 3009 1 Hex QUEUE_REMOTE_LABEL_TYPE Remote label type
000BC2 3010 1 Hex QUEUE_CRC_FLAG CRC flag:
  • 0x80: Initiator supports CRC
  • 0x40: Responder supports CRC
000BC3 3011 1 Char QUEUE_TLS_SECTYPE TLS security type:
  • 0: TLSv1
  • 1: TLSv1.1
  • 2: TLSv1.2
000BC4 3012 4 Hex QUEUE_CRC CRC computed
000BC8 3016 8 Binary QUEUE_TIMEUSED Time used by the transfer task
000BD0 3024 4 Char QUEUE_TLS_CIPHERUSED Cipher used in SSL or tunnel mode
000BD4 3028 1 Hex QUEUE_FILE_OPTIONS2 Truncate flag:

0x80 Truncate data

0x40 Wrap truncated data

000BD5 3029 1 Hex QUEUE_CCSID_BOM_FLAG BOM flag for ICONV conversion:
  • 0x80: Add BOM
  • 0x40: Remove BOM
000BD6 3030 1 Hex QUEUE_PREPOSTPROC_FLAG Directory transfer preprocessing and postprocessing flag
000BD8 3032 8 Binary QUEUE_TIMEUSED_TLS Time used by SSL/Tunnel and ZLIB compression task
BE0 3040 8 Binary QUEUE_FILE_ERROR_TRY_MAX File error try max count
BE2 3042 8 Binary QUEUE_FILE_ERROR_TRY_INT File error try interval
BE4 3044 8 Binary QUEUE_STCNAME Name of STC that executed this transfer.