SMF Type 241 Record

Function statistics record length.

RDW SEGMENT DESCRIPTOR

Operating environment.

System management facility record identification associated with function statistics records.

TOD REC WRITTEN NX

DATE RECORD WRITTEN NX

Reserved.

System identification from the computing system.

Job name requesting the function.

Job start time. The time is obtained from the TIME macro in hundredths of seconds.

Reader start date. The date is obtained from the TIME DEC macro in format X'0cyyddds'.

ID of the user requesting the function.

DFSMShsm function type:
1 = Primary to level 1 migration
2 = Level 1 to level 2 migration, or level 1 to level 1 migration, or level 2 to level 2 migration
3 = Primary to level 2 migration
4 = Recall from level 1 to primary
5 = Recall from level 2 to primary
6 = Delete a migrated data set
7 = Daily backup
8 = Spill backup
9 = Recovery
10 = Recycle backup volume
11 = Data set deletion by age
12 = Recycle migration volume
13 = Full volume dump
14 = Volume or data set restore
15 = ABACKUP function see WWSMF241_FSR control block)
16 = ARECOVER function see WWSMF241_FSR control block)
17 = Expire primary or migrated data sets
18 = Partrel function
19 = Expire or roll off incremental backup version
20 = H)BDELETE an incremental backup version
21 = Fast replication backup function
22 = Fast replication recover function
23 = Fast replication delete function.

This byte contains the following flags:
1... .... SMF241_FSRFFSTR When set to 1, from a striped data set.
.1.. .... SMF241_FSRFTSTR When set to 1, to a striped data set.
..1. .... SMF241_FSRF32K When set to 1, data set is greater than 32K tracks. Use fields SMF241_FSRTRKKR and SMF241_FSRTRKKW instead of SMF241_FSRTRKR and SMF241_FSRTRKW.
...1 .... SMF241_FSRFKB When set to 1, data set is greater than 2GB. Fields SMF241_FSRBYTR and SMF241_FSRBYTW represent KB 1024 bytes).
.... 1... SMF241_FSRFVER When set to 1, SMF241_FSRGEN contains a version number.
.... .1.. SMF241_FSRFNONQ When set to 1, DFSMShsm was directed to not serialize (enqueue before making a backup copy.
.... ..1. SMF241_FSRFNQN1 When set to 1, data set was backed up even though enqueue failed once).
.... ...1 SMF241_FSRFNQN2 When set to 1, attempted enqueue failed, backup was retried and enqueue failed again.

The next 92 bytes contain information from the management work element for the request.

Data set name. For types 21, 22, and 23, this field contains the copy pool name.

Receiving volume from the management work element. Also used for fast replication.

Receiving device type as defined by the UCB. If SMF241_FSRTYPE=10 or 12, this is for the recycle target volume.

Serial number of the original volume from the management work element.

For volume restore only: Target volume from MWE SMF241_FSR_RECYCLE_SOURCE_VOLSER For recycle only: Source volume for recycle - first volume of a connected data set.

Backup copy generation number if SMF241_FSRFDAT is set to 0 and SMF241_FSRFVER is set to 0. Backup copy version number if SMF241_FSRFDAT is set to 0 and SMF241_FSRFVER is set to 1.

Backup date if SMF241_FSRFDAT is set to 1 and a recovery command with a from date was specified. The date is obtained from the TIME DEC macro in format X'0cyyddds'.

Return code from the management work element. Use this field along with the SMF241_FSRTYPE field to find out what function was running. Then, see message ARC0734I to determine what the return code means.

Reason code from the management work element.

Abnormal end code if there is one.

Dynamic allocation return code.

RACF group name.

RACF flags from the ACEEFLG1 field of the attachment environment element.

Flags from the MWE.
1... .... SMF241_FSRFRTRY When set to 1, the backup copy was made during a retry, after the first try failed because the data set was in use.
.1.. .... SMF241_FSRF_REMOTE When set to 1, this request completed successfully on a remote system.
..1. .... SMF241_FSRFPIGB When set to 1, the request was completed using a tape already mounted.
...1 .... SMF241_FSRF_REMOTE_HOST_PROCESSED When set to 1, MWE processed by remote host.
.... 1... SMF241_FSRF_DASD When set to 1, the DASD copy of the version was deleted.
.... .1.. SMF241_FSRF_DUMPCPY When set to 1, the dump class of the copy pool dump was deleted.
.... ..1. SMF241_FSRF_DUMPVER When set to 1, the entire dump version of the copy pool version was deleted.
.... ...1 SMF241_FSRF_COPYPOOL_FRDUMP A value of 1 indicates a fast replication dump or restore.

DFSMShsm request number.

Date the user made the request. The date is obtained from the TIME DEC macro in format X'0cyyddds'.

Time the user request was received by DFSMShsm. The time is obtained from the TIME macro in format X'hhmmssth'.

Time when the request processing was started. The time is obtained from the TIME macro in format X'hhmmssth'.

Alias name for BACKUP and RECYCLE.

Time when the request processing was completed. The time is obtained from the TIME macro in format X'hhmmssth'.

Alias name for BACKUP and RECYCLE.

Time when the data set allocations were completed. The time is obtained from the TIME macro in format X'hhmmssth'. The value of SMF241_FSRTIMA minus the value of SMF241_FSRTIMS equals the mount time.

Data set last reference date for migration or the last change date for backup. The date is obtained from the TIME DEC macro in format X'0cyyddds'.

Date that the data set was last moved, migrated, backed up, or recalled. The date is obtained from the TIME DEC macro in format X'0cyyddds'.

If SMF241_FSRFKB is set to 0, then the number of DASD bytes read. If SMF241_FSRFKB is set to 1, then the number of DASD KB 1024 bytes) read. Note: This SMF241_FSR field is significantly affected by DFSMSdss control information added to the data stream when DFSMSdss is the datamover SMF241_FSRTRKR and SMF241_FSRTRKKR are not affected during migration or backup).

If SMF241_FSRFKB is set to 0, then the number of DASD bytes written. If SMF241_FSRFKB is set to 1, then the number of DASD KB 1024 bytes written. See note under the SMF241_FSRBYTR field.

If SMF241_FSRF32K is set to 0, then if SMF241_FSRTYPE is 17 or 18 EXPIRE or PARTREL it is the number of tracks freed; otherwise this is the number of DASD tracks read. If SMF241_FSRF32K is set to 1, then this field is not valid; use SMF241_FSRTRKKR instead. If this field is negative, then processing to an SDSP. See note under the SMF241_FSRBYTR field.

If SMF241_FSRF32K is set to 0, then the number of DASD tracks written. If SMF241_FSRF32K is set to 1, then this field is not valid; use SMF241_FSRTRKKW instead. If this field is negative, then processing to an SDSP. See note under the SMF241_FSRBYTR field.

Data set organization. Values have the same meanings as DS1DSORG in F1 DSCB. If the data set is moved or copied from a L0 volume, the field shows the original user data set organization. If the data set is a DFSMShsm data set for example, migration copy or backup version), this field always indicates physical sequential data set organization.

First byte of SMF241_FSRDORG, skipped.

Second byte of SMF241_FSRDORG.
xxxx .... Reserved.
.... 1... SMF241_FSRFVSDS When set to 1, this is a VSAM data set.
.... .x.. Reserved.
.... ..1. SMF241_FSRF_F9ATT When SMF241_FSRTYPE = 4, 5, 9, 14: When set to 1, F9 DSCB extended attributes lost
.... ...x Reserved.

The next 2 bytes contain the following request flags:
1... .... SMF241_FSRFMNT When set to 1, the volume is mounted.
.1.. .... SMF241_FSRTSO When set to 1, it is TSO requested. When set to 0, it is batch requested.
..1. .... SMF241_FSRUSER When set to 1, it is a data set request from a user address space. When set to 0, it is system requested.
...1 .... SMF241_FSRWAIT When set to 1, a wait was requested. When set to 0, the user did not wait for the request to complete.
.... 1... SMF241_FSRFDAT When set to 1, the SMF241_FSRDATE has the date when the function statistics record was created. When set to 0, the SMF241_FSRDATE contains the generation number.
.... .1.. SMF241_FSRFRSV When set to 1, the user specified the volume for a recall of a data set.
.... ..1. SMF241_FSRFML2 When set to 1, the user specified migration directly to level 2. .... ...1 SMF241_FSRFFRV When set to 1, the user specified the FROM volume for a data set recovery. 179 B3
1... .... SMF241_FSRFREP When set to 1, the user specified the REPLACE parameter for a data set recovery.
.1.. .... SMF241_FSRFDSRE When set to 1, the statistics associated with a data set restore from a full volume dump are being requested.
..1. .... SMF241_FSRFAPIN When set to 1, APPLYINCREMENTAL has been requested following a full volume restore.
...1 .... SMF241_FSRFEXT When set to 1, extent reduction has been requested.
.... 1... SMF241_FSRFCNVT When set to 1, conversion has been requested.
.... .1.. SMF241_FSRFROG When set to 1, the GDS has been rolled off.
.... ..1, SMF241_FSRFDSS When set to 1, data set was moved by DFSMSdss.
.... ...1 SMF241_FSRFT0 When set to 1, concurrent copy function was used to back up the dataset.

CPU time in .01 seconds for request.

Data set age in days since the last reference for a migration, since last update for a backup, since migration was done for a recall, or since last update for a recovery.

Record format from the DSCB.

I/O option codes from the data set control block.

Count of recalls or recovers thus far from a mounted tape i.e.. number of tape mounts avoided).

Number of attempts to recall a data set before the recall was successful.
1... .... SMF241_FSRF_LFS_COPY ON - Migration copy or backup version is LFS
.1.. .... SMF241_FSRF_ML1_OVERFLOW ON - Migration copy or backup version is on ML1 OVERFLOW volume
..1. .... SMF241_FSRF_NOOVERFLOW_DS ON - NOOVERFLOW eligible data set has been redirected up to a OVERFLOW volume
...1 .... SMF241_FSRF_OVERFLOW_DS ON - OVERFLOW eligible data set has been redirected up to a NOOVERFLOW volume

When SMF241_FSRTYPE = 21, 22, 23: Requested method of fast replication. The valid methods are:
1=None
2=Preferred
3=Required SMF241_FSR_RECYCLE_COUNTER When SMF241_FSRTYPE = 5: Number of times a data set was recycled before being recalled. When SMF241_FSRTYPE = 12 Number of times a data set has been recycled since its last migration.

Additional flags
1... .... SMF241_FSRF_BACKDS_NEWNAME When SMF241_FSRTYPE = 7: When set to 1, NEWNAME specified at time of backup
.1.. .... SMF241_FSRF_BACKDS_NOSPHERE When SMF241_FSRTYPE = 7: When set to 1, NOSPHERE processed at time of backup
..1. .... SMF241_FSRF_BACKDS_RD_SPCD ON=RETAINDAYS specified at time of ds backup
...1 .... SMF241_FSRF_BACKDS_NEVER_EXP When set to 1, this version will never expire. Only valid when SMF241_FSRF_BACKDS_RD_SPCD is set to 1.

Recall/recover/recycle source. Last two bytes of device type.

Length of storage-class name.

First 8 characters of storage-class name.

If SMF241_FSRF32K is set to 1, then if SMF241_FSRTYPE is 17 or 18 EXPIRE or PARTREL it is the number of tracks freed; otherwise this is the number of DASD tracks read. If SMF241_FSRF32K is set to 0, then this field is not valid. Use SMF241_FSRTRKR instead. See note under the SMF241_FSRBYTR field.

If SMF241_FSRF32K is set to 1, then the number of DASD tracks written. If SMF241_FSRF32K is set to 0, then this field is not valid. Use SMF241_FSRTRKW instead. See note under the SMF241_FSRBYTR field.

Length of management class name zero means there is no management class).

Name of the management class. If field SMF241_FSRMCLEN is greater than 8, this field contains the first 8 characters of the name.

Request flags:
1... .... SMF241_FSRFVINI When set to 1, the data set recovery request was scheduled from a volume request.
.1.. .... SMF241_FSRFXPL1 When set to 1, the data set being expired is from an ML1 volume.
..1. .... SMF241_FSRFXPL2 When set to 1, the data set being expired is from an ML2 volume.
...1 .... SMF241_FSRFEXBV When set to 1, the backup version is being deleted by the EXPIREBV command.
.... 1... SMF241_FSRFBKTP When set to 1, the backup version being deleted is on a tape volume.
.... .1.. SMF241_FSRFEXDT When set to 1, the data set is being deleted by expiration date or management class age attributes.
.... ..1, SMF241_FSRRECON When set to 1, data set was migrated because of reconnection.
.... ...1 SMF241_FSRF_RECALL_TAKEAWAY When set to 1, this recall caused a tape-takeaway.

Flags
1... .... SMF241_FSRF_FRRECOV_DSNAME When set to 1, fast replication recovery was requested for a data set through the FRRECOV DSNAME command.
.1.. .... SMF241_FSRF_FRRECOV_FROMDISK When set to 1, fast replication recovery will be performed from disk. This flag is set only when SMF241_FSRF_FRRECOV_DSNAME is set to 1.
..1. .... SMF241_FSRF_MULT_DSNAMES When set to 1, the fast replication recovery request specified more than one data set name.
...1 .... SMF241_FSRF_MULTIVOLUME When set to 1, the fast replication recovery request was performed on part of a multi-volume data set. This flag is set only when SMF241_FSRF_FRRECOV_DSNAME is set to 1.
.... 1... SMF241_FSRF_ALTERPRI When set to 1, the priority of this request was altered through the ALTERPRI command.
.... .1.. SMF241_FSRF_ALTERPRI_HI This flag applies only when SMF241_FSRF_ALTERPRI is set to 1. When set to 1, the HIGH keyword was specified on the ALTERPRI command. When set to 0, the LOW keyword was specified.
.... ..1, SMF241_FSRF_INC When set to 1, copy pool incremental processing was used.
.... ...1 SMF241_FSRF_CPBSG When set to 1, FRBACKUP override CPBSG

Time preprocessing completed for BACKUP. The time is obtained from the TIME macro in format X'hhmmssth'.

Time data movement started for RECYCLE. The time is obtained from the TIME macro in format X'hhmmssth'.

Time data movement completed for BACKUP and RECYCLE. The time is obtained from the TIME macro in format X'hhmmssth'.

Time post-processing started for BACKUP and RECYCLE. The time is obtained from the TIME macro in format X'hhmmssth'. If tape volumes are used, the following fields are used instead of SMF241_FSRTVOL, SMF241_FSRFVOL, SMF241_FSRBYTR, SMF241_FSRBYTW, and other DASD-specific fields:

Number of tape volumes used for backup, recovery, or migration level 2, or the number of recycle input tapes for recycle processing, or the number of dump copies, depending on the function type specified in the SMF241_FSRTYPE field. The tape volume entries follow the BINARY portion of the control block.

Number of output recycle tape entries that follow the SMF241_FSRNENT1 entry.

Number of dump copies requested.

Number of attempted dump copies that failed. SMF241_FSR_CPNAME and SMF241_FSRDCLAS use the same storage, SMF241_FSR_CPNAME is used when SMF241_FSRF_FRRECOV_DSNAME is set to 1.

Copy pool name. This flag is set only when SMF241_FSRF_FRRECOV_DSNAME is set to 1.

A 5-element array consisting of 8-byte fields containing the names of dump classes.

Host identifier.

Host ID that generated the request. This field is valid only for recall requests.

During fast replication: Fast replication return code. SMF241_FSR_PSQTY During migration: The number of tracks needed when an error occurred due to not enough ML1 space.

RETAINDAYS value for data set backup

More flags
1... .... SMF241_FSRFMB When set to 1, SMF241_FSRBYTR and SMF241_FSRBYTW are in Mbytes
.xxx xxxx Reserved Reserved

Reserved The following tape volume entries, starting at offset 300 12C), are valid for each tape volume that is used as indicated in the SMF241_FSRNENT1 and SMF241_FSRNENT2 fields. The entries for the SMF241_FSRNENT1 field are first.

Tape volume entry.

Volume serial numbers. For dump processing, this field contains only the first volume serial number in each dump copy.

This byte contains the following flags:
1... .... SMF241_FSRFTKB When set to 1, more than 2GB worth of data, SMF241_FSRTBYBK represents KB 1024 bytes). When set to 0, less than 2GB worth of data, SMF241_FSRTBYBK represents bytes.
.1.. .... SMF241_FSRFALT When set to 1, the data set on this volume was written in duplex mode; therefore, the total amount of output is twice that shown in the bytes written.
..1. .... SMF241_FSRFTMB When set to 1, SMF241_FSRTBYBK is in Mbytes
...x xxxx Reserved.

Reserved.

The next 4 bytes contain one of the following:
- For backup processing, if SMF241_FSRFTKB is set to 0, then bytes written. If SMF241_FSRFTKB is set to 1, then KB 1024 bytes) written.
- For recycle output processing, the blocks written.
- For recycle input processing, the blocks read.
- For recovery processing, if SMF241_FSRFTKB is set to 0, then bytes read. If SMF241_FSRFTKB is set to 1, then KB 1024 bytes read.
- For migration processing, if SMF241_FSRFTKB is set to 0, then bytes written. If SMF241_FSRFTKB is set to 1, then KB 1024 bytes) written.
- For recall processing, if SMF241_FSRFTKB is set to 0, then bytes read. If SMF241_FSRFTKB is set to 1, then KB 1024 bytes read.
- For delete migrated data set processing, the total number of bytes deleted for the entire data set appears in the bytes read entry for the first tape volume serial number.