User fields for the Cross-System Work extract

To display the User Fields subpanel, enter line action S against User Fields on the Cross-System Work Extract panel.
Figure 1. Cross-System Work Extract: User Fields
   File  Filter  Edit  Options  Help  
 -----------------------------------------------------------
                        User Fields             Row 1 from 7
 Command ===> ___________________________ Scroll ===> PAGE
 
                                   Char    Maximum
 /   Exc  Dictionary Definition    Length  Length
 _        CLOCK1   CPAUSR1 S001     ___       8
 _    *   CLOCK2   CPAUSR1 S002     ___       8
 _        CLOCK3   CPAUSR1 S003     ___       8
 _        COUNT5   CPAUSR2 A005     ___       4
 _    *   RMIDATA  DBCTL   C001     256     256
 _        FIELD1   CPAUSR1 C001     _12      12
 _        FIELD1   CPAUSR2 C001     _12      12
 ********************************* End of list *************
 

This panel displays the user fields to be included in the Cross-System Work Extract record. The list of fields is initially populated by CICS PA using the specified APPLID to locate the MCT. You can change the Include/Exclude status of the fields, or delete unwanted fields, but when deleted they cannot be reinstated. You can also modify the length of character fields.

The options are:
Exclude Indicator
An asterisk (*) in this field indicates that the row is excluded and will not be included in extract processing.

Use line action X to reverse the Exclude indicator.

Dictionary Definition
The description of the user field in the format informalname owner xnnn where:
  • informalname is the CMF informal name for the field. This is placed in the dictionary record of the Cross-System Work Extract and can be used in subsequent reporting, for example, as the column heading.
  • owner is the CICS® component that 'owns' the field.
  • x indicates the data type:
    • A - 32- or 64-bit count
    • C - character string
    • S - clock (both Time and Count parts are extracted)
  • nnn is the field identifier. For Clock or Count fields, this identifies which of the 256 clocks and 256 counts are extracted. For character fields, it will always be 001.
Character Field Length
The length of the field in the extract record, for character user fields only. If this length is shorter than the maximum length of the field, the value is truncated in the extract. Values longer than the field length are not allowed.
Maximum Length
The original length of the user field. For clock or count fields, this is the length of the field in the extract record. For character fields, this length can be overridden by changing the Char Length value.
Line Actions: The valid line actions on this panel are:
Display the menu of line actions
D
Delete this field (Deleted fields cannot be reinstated)
X
Reverse this row's Exclude status (Exclude/Include)