Keywords › PROCNAME Keyword—Define STC Procedure

PROCNAME Keyword—Define STC Procedure

Valid on z/OS.

Use the PROCNAME keyword to define a started task to CA Top Secret by associating the STC procedure name with an ACID or action.

An STC procedure can be generically defined to the STC table. Use an asterisk at the end of an STC procedure entry to signify that the stcname is considered a prefix at run-time. If multiple STC entries match an STC, CA Top Secret selects the best match based on the following selection criteria:

• Exact match of non-generic entry
• Longest matching generic entry
• If there is no matching generic entry, the default STC ACID is used
• If there is no DEFAULT stcname, the STC FACILITY DEFACID is assigned
• If no ACID can be determined, the MODE of the STC facility determines the disposition of the started task

For information, see the User Guide and Implementation: Batch, STC, and APPC Guide.

The STCACT attribute can force the operator to identify the ACID and PASSWORD that entered the START command for the associated PROCNAME. The signon of this operator accountability ACID generates a logged event. STC AccounTability (STCACT) when called for (message TSS7152A) provides:

• A separate identification prior to prompting the operator for an optional execution ACID (PROMPT, resulting in TSS7151A)
• An execution PASSWORD (when the ACID of the STC definition contains a password other than NOPW, resulting in TSS7150A)

For information, see the STCACT keyword.

This keyword has the following format:

TSS ADDTO(STC) PROCNAME(stcname|DEFAULT)
               ACID(acid|action)
               [STCACT]

stcname

The STC procedure name.

Range: 1 to 8 characters

DEFAULT

Provides undefined started tasks with a default ACID or default action. A started task is undefined if the procname in the operator console START command does not match any of the STC PROCNAME procedures or prefixes on file.

acid

Pre-existing ACID that CA Top Secret assigns the started task with designated PROCNAME. If the ACID is defined with a significant password (other than NOPW), the system console prompts for the PASSWORD associated with "acid." If the ACID is deleted, if the stcname procedure is started and assigned to this now invalid ACID. An error is issued by the delete but the command is allowed to continue.

Range: 1 to 8 characters

action

If no ACID was created for the STC, choose one of the following actions:

• BYPASS—Security checking for the stcname is bypassed. This is not recommended for complex tasks like CICS, where BYPASS security can cause security failure and unpredictable outcomes during initialization and transaction execution.
• FAIL—The stcname initiation fails.
• PROMPT—The console operator is prompted for an ACID and password assigned for this instance of the started task of this stcname.

STCACT

When this keyword is present on an ADD command, the console operator is prompted for an accountability ACID and password, responsible for entering the START operator command. This ACID is separate from the ACID assigned to execute the started task provided by the ACID operand: it provides a logged event for accountability of the START command.

This keyword is used with:

• The commands ADDTO, REMOVE, and LIST
• The STC special record only
• MISC9(STC) authority