Previous Topic: TSSREPT UtilityNext Topic: TSSREPT Option 2


TSSREPT Selection Screen

Interactive screens are available to create, save, and view reports generated by TSSREPT. Defaults are defined at installation. Enter TSSREPT and the report selection screen appears.

TSSREPT Option 1

Reports 1 through 7 are described on the following pages. Input parameters, if any, appear in the boxes and are followed by definitions of both required and optional parameters. The following OUTPUT FIELDS define the headers that appear on the report output.

The DATE format for each report is MM/DD/YY. This can be modified with the CA-EARL installation options. See the CA-ACTIVATOR Installation Supplement.

 CAKV-R001                 Top Secret Report Facility                   TSSREPT

===>
Select the type of CFILE request:  (2)        (3)                    (4)
  _ dynamic, from TSS server: TSSVM___ node: ________ with password:
(1)    TSS LIST command(s) or _ command file TSSREPT_ TSSLIST_ A_ to execute:
                             (6)                       (7)
       ________________________________________________________________________
       ____(5)_________________________________________________________________
       ________________________________________________________________________
 (8)                                                                      (9)
  _ static, CFILE in virtual reader, enter the jobid of its TSSCFILE JOB: ____
(10)   _ Check here to save CFILE as: TSSCFILE SAVED___ A_ (11)
  _ static, CFILE on minidisk, enter its CMS fileid: TSSCFILE SAVED___ A_
(12)                                                                (13)
                                                               (14)
Select the TSS report ( v - view, s - create and save as TSSREPTn LISTING_ A_ )
  _ Report 1: inactive ACIDs            _ Report 2: expired ACIDs
  _ Report 3: suspended ACIDs  (15)     _ Report 4: ACID names
  _ Report 5: all ACIDs                 _ Report 6: ACIDs with given attributes
  _ Report 7: ACIDs w/ ADMIN authority  _ Report produced by EARL pgm: __(16)__
    Input parameter for EARL (if any): _____________(17)_______________________

PF1=Help       2=           3=End         4=Return     5=Execute    6=
PF7=SaveCurr   8=GetSaved   9=Refresh    10=          11=          12=Cursor

The following information is presented in the display:

Note: This screen is a two-step process: The upper part of the screen about the CFILE request must be filled in first. Interactive messages will guide you through the process. When the PUN and PRT files are returned, you can then fill in the lower portion of the screen about the CA Top Secret report selection.

REPORT #1 INACTIVE ACIDS

PF Key

Assignments:

PF1=Help

Invokes the Help Facility

PF2

Not applicable for TSSREPT

PF3=End

Exits TSSREPT

PF4=Return

Exits TSSREPT

PF5=Execute

Performs the selected action

PF6

Not applicable for TSSREPT

PF7=SaveCurr

Saves the current entered values

PF8=GetSaved

Re-displays the saved values

PF9=Refresh

Re-displays screen, no previous entries are saved

PF10

Not applicable for TSSREPT

PF11

Not applicable for TSSREPT

PF12

Moves cursor between command line and previous screen position

Lists all ACIDs that are inactive. An ACID is considered “inactive” and will be denied access to the system after a specified amount of time that was pre‑determined with the INACTIVE control option.

INACTIVE(nnn)
nnn

This number should be set to match the installation-selected CA Top Secret INACTIVE control option parameter, which is any number from 0 to 255.

Output fields are as follows:

ACID

Lists the resulting inactive ACIDs.

NAME

Lists the user's name associated with each ACID.

DATE ON WHICH ACID BECAME INACTIVE

Lists the date CA Top Secret denied the ACID access to the system.

A 1980 date under this header means that the user's password had been assigned the EXP parameter (to expire immediately).

The TSS command for TSSCFILE for this particular report is:

TSS LIST(acids) DATA(ALL,PASS)

REPORT #2: EXPIRED ACIDS

Lists all ACIDs that are expired.

PARM=

There are no input parameters for this report.

Output fields are as follows:

ACID

Lists the expired ACIDs.

NAME

Lists the user's name associated with each ACID.

DATE ON WHICH ACID EXPIRED

Lists the date each ACID expired.

REPORT #3: SUSPENDED ACIDS

Lists all ACIDs that are suspended.

PARM=

There are no input parameters for this report.

Output fields are as follows:

ACID

Lists the suspended ACIDs.

PROFILE INDICATOR

A P in this column means that the listed ACID is a profile ACID.

NAME

Lists the name associated with each listed ACID.

DATE ON WHICH ACID WILL RESUME

Output appears here only if the ACID in question has been temporarily suspended. This is the date it will resume after the temporary suspension.

REPORT #4: ACID NAMES

Lists ACIDs in alphabetical order by name. The following parameters may be used to specify the order in which the user wants the ACIDs sorted. One and only one of the first four parameters must be specified; the delimiter and A or D are optional.

FIRST|LAST|Pnn|Cnn[,delimiter][,A|,D].
FIRST

This parameter sorts by first name, starting with the first nonblank character in the name field.

LAST

This parameter sorts by last name, starting with the first character following the last delimiter found, or, if no delimiters are found, starts with column 1.

Pnn

This parameter sorts by nnth positional subfield. The subfield to be sorted starts with the first character after the (nn-1)th delimiter and ends with the next delimiter or the last character in the name field, whichever occurs first. If a subfield specified is outside the range of fields found on a name being sorted, the following error message will be generated:

    ***SUBFIELD nn WAS NOT FOUND IN THE NAME FIELD***
Cnn

This parameter sorts by the entire name field, beginning with column nn (with nn equalling a number 1 through 20), and ending with the last character in the name field.

delimiter

This parameter is optional. It cannot be used if Cnn was used. The delimiter is the one-byte character indicating a separation between positional subfields within the ACID name (such as a comma, blank, or hyphen). Default is a blank.

A

(Default) This parameter is a default. It sorts in ascending alphabetical order (EBCDIC collating sequence). If this parameter is selected, a report is also generated in descending order, with the note: “Descending order report not selected for this run.” Conversely, a request for descending order will result in the additional ascending-order report and note.

D

This parameter sorts in descending alphabetical order. A.

Enter your parameters exactly as shown above. For example, even if the delimiter you select is a comma, you must still use a comma before this delimiter, as in the following example:

PARM='P8,,,D'

The report title indicates which options were selected, and which delimiter, if any, is used. Output fields are as follows

NAME

Lists the given names in the order specified.

ACID

Lists the ACID associated with each name.

REPORT #5: LIST OF ACIDs

Lists ACIDs in alphabetical order by selected positions within the ACID.

      [Scc][,Ecc][,A|,D]
Scc

This parameter sorts by starting column position within the ACID. Select column one through eight. This parameter is optional. Default is S1.

Ecc

This optional parameter sorts by ending column position within the ACID. The default is E8. Select column 1 through 8, but the number must be greater than or equal to Scc. If an Ecc is specified that is less than Scc, the job will terminate execution and the following message will appear in place of the report:

INVALID PARAMETER-NO REPORT PRODUCED
A

(Default) This is the default parameter. This parameter sorts in ascending alphabetical order (EBCDIC collating sequence). If this parameter is selected, a report is also generated in descending order, with the note: “Descending order report not selected for this run.” Conversely, a request for descending order will result in the additional ascending-order report and note.

D

This parameter sorts in descending alphabetical order.

The report title indicates whether ascending or descending order was selected, and which starting and ending column positions were selected for the sort. Output fields are as follows:

ACID

Lists the ACIDs in the order specified.

NAME

Lists the given name for the ACIDs being listed.

REPORT #6: WHO HAS ATTRIBUTES

Lists ACIDs that have the attribute specified.

[attribute]
attribute

The attribute is any CA Top Secret attribute that may be assigned to a user or profile ACID.

Output fields are as follows:

ACID

Lists the ACIDs that have the attribute.

PROFILE INDICATOR

A P under this header indicates that the ACID is a profile ACID.

NAME

Lists the given name for the ACIDs being listed.

ATTRIBUTES

Refers to the attribute specified. An asterisk appears before each BYPASS attribute: NODSNCHK, NOVOLCHK, NOLCFCHK, NOSUBCHK, NORESCHK. When an ACID having the attribute requested is found, all of that ACID's attributes (either BYPASS or non-BYPASS) will be shown. If no PARM was specified, all ACIDs having any attribute will be shown.

REPORT #7: WHO HAS ADMINISTRATIVE AUTHORITIES

Lists ACIDs that have administrative authorities, and their scope of authority.

PARM=

There are no input parameters for this report.

ACID, TYPE, and SCOPE OF AUTHORITY listings appear on the first line of this report; AUTHORITY TYPE and AUTHORITY LEVEL appear on the second line, and ACCESS levels, if any, are on the third line.

ACID

Lists the ACIDs.

TYPE

Lists each ACID type: MASTER, CENTRAL, DIV C/A, DEPT C/A, PROFILE or USER.

SCOPE OF AUTHORITY

Lists scope of authority, with the format:

ACIDNAME(scope)

If the TYPE is MASTER or CENTRAL, the scope is ALL.

AUTHORITY TYPE

Authority type will be one of the following: FACILITY, ACID, LIST DATA, MISC1, MISC9, RESOURCE, or a predetermined specific resource class name, such as DATA SET.

AUTHORITY LEVEL

The ACID's authority levels are listed after Authority Type.

ACCESS

After [authority level]:XAUTH, "access" indicates the access levels the ACID may use to cross-authorize (PERMIT) users to the corresponding resource after [authority type].

The TSS command for TSSCFILE for this particular report is:

TSS LIST(acids) DATA(ALL)