Previous Topic: TSSCFILE JCL RequirementsNext Topic: Formatted Record Types

TSSCFILE Utility › Samples of Formatted Security File Records

Samples of Formatted Security File Records

TSSCFILE generates a fixed format record for each data line produced by the TSS LIST command(s). Each record contains a four to six character record identifier.

All records are described in this section using the following format: start column, end column, field length, and description.

For example:

FIELD       FIELD       FIELD        DESCRIPTION
START       END         LENGTH
COL         COL

33          52             20            NAME

The following record heading is standard on all records:

1     2      2       RESERVED
3     4      2       RESERVED
5     8      4       RECORD ID 1
9     10     2       RECORD ID 2
11    11     1       CONTINUE FLAG: "C"
12    14     3       RESERVED
15    22     8       ACID
23    32     10      RESERVED

Note: The record IDs and the continue flags are discussed on the following page.

Each record of a TSSCFILE output is described within a boxed area as follows:

      ---1--        2
------|------|------|----------------------------------------------------
|     v      v      v                                                   |
|    ID:   0100  "NAME        ="                                        |
|    33    52     32           NAME                                     |
-------------------------------------------------------------------------
      |     |      |             |
      3     4      5             6

Note the following items:

  1. Indicates the ID associated with this type of TSSCFILE output record. The record ID is four to six positions in length and is part of the record header. The first four positions identify the record ID. If displayed, positions five and six identify the hexadecimal code representing the resource being listed.
  2. Indicates the keyword that identifies the type of information found on the TSS information retrieval command output. This keyword is also found with each TSSCFILE record description and its associated ID. The actual printed output of TSSCFILE does not show keywords (e.g., "NAME =").
  3. Indicates the starting column of the field containing information within a specific TSSCFILE record--column 33 in this example. The record header comprises the first 32 characters.
  4. Indicates the ending column of the field--column 52 in this example.
  5. Indicates the length of the field--32 characters in this example.
  6. Indicates the information found within the specific column positions.

A record ID can have more than one field described. (See record ID 0500 as an example.)

All fields within a printed TSSCFILE record output are left justified.

An illustration of the output of a CA Top Secret information retrieval command and how TSSCFILE formats the same output to the PRINT data set follows.

  READY
    TSS LIST(USER02) DATA(ALL,PAS)
  ACCESSORID = USER02    NAME       = TEST ACID
  TYPE       = USER      SIZE       =      512  BYTES
  DEPT ACID  = TESTDEPT  DEPARTMENT = TEST DEPARTMENT
  DIV ACID   = TESTDIV   DIVISION   = TEST DIVISION
  CREATED    = mm/dd/yy  LAST MOD   = mm/dd/yy  08:52
  XA TSOACCT = 11111111                                      OWNER(BOBBBY01 )
  XA TSOAUTH = CONSOLE                                       OWNER(BOBBBY01 )
  XA TSOAUTH = JCL                                           OWNER(BOBBBY01 )
  XA TSOPROC = TSOPROC                                       OWNER(BOBBBY01 )
  INSTDATA   = 739-4001
  -----------  SEGMENT TSO
  TSOCOMMAND = ISPF
  TSODEFPRFG = 255
  TSODEST    = LOCALC
  TSOHCLASS  = X
  TSOJCLASS  = A
  TSOLACCT   = 11111111
  TSOLPROC   = TSOPROC
  TSOLSIZE   = 0002048
  TSOMCLASS  = X
  TSOMSIZE   = 0004096
  TSOOPT     = MAIL,NOTICES
  TSOSCLASS  = *
  TSOUDATA   = ABCD
  TSOUNIT    = SYSDA
  PASSWORD   =

  TSS0300I  LIST     FUNCTION SUCCESSFUL
              TSSCFILE                                PAGE   1

     *==============================================================================*
       TSS LIST(USER02) DATA(ALL)
     *==============================================================================*
              TSSCFILE     SECURITY FILE DATA


                                   3
     <..........HEADING...........><....+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8...
     <0001                        ><TSS LIST(USER02) DATA(ALL)>
     <0100      USER02            ><TEST-USER>
     <0200      USER02            ><USER>
1    <0300      USER02            ><APPCDEPTAPPC DEPT>
     <0500   2  USER02            ><01/30/9502/02/9512:48>
     <170087    USER02            ><TSOACCT 11111111>
     <170088    USER02            ><TSOAUTH CONSOLE>
     <170088    USER02            ><TSOAUTH JCL>
4    <170089    USER02            ><TSOPROC TSOPROC>
     <2600      USER02            ><021INSTDATA=739-4001
                                   <
                                   <>
     <4010      USER02            >Unicenter TSreorg for Oracle
     <3508      USER02            ><ISPF>
     <3506      USER02            ><255>
     <3509      USER02            ><LOCALC>
     <3510      USER02            ><X>
     <3502      USER02            >Action:
     <3501      USER02            ><12345678>
     <3500      USER02            ><TSOPROC>
     <3504      USER02            ><0002048>
     <3503      USER02            ><X>
     <3511      USER02            ><0004096>
     <3507      USER02            ><NOMAIL NONOTICES>
     <3512      USER02            ><*>
5    <3505      USER02       5    ><ABCD>
     <3513      USER02            ><SYSDA>  6

The following is the legend for the numbered items in the TSSCFILE Format Records example.

Record ID which contains TSSCFILE output information associated with a specific data line of a TSS LIST command. In other words, record ID 0200 is associated with the information found in "TYPE=" of the TSS LIST command data line.

ACID associated with the TSS LIST command found in record ID 0001. Numbers 1 and 2 are found in the record heading.

Indicates the starting column on the grid for significant information within a TSSCFILE printed output, which is column 33. (It can also be considered as relative position 1.)

Record IDs 170087 thru 170089 indicate the TSO-related resources that the ACID is allowed to access.

The record heading is delimited by less than (<) and greater than (>) signs. They are placed one position before and one position after the 32-character length of the record heading.

Delimiters are also used here to show the length of potential significant information within the bounds of the data portion of a TSSCFILE record.

Note: Blanks will be supplied for any field that does not contain data. If a “C” appears after a record ID as part of the record heading, it indicates that the following record will continue the current record.

More information:

Formatted Record Types