PROCNAME Keyword—Define STC Procedure

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

Examples: PROCNAME keyword

This example fails all undefined STCs:

TSS ADDTO(STC) PROCNAME(DEFAULT)
               ACID(FAIL)

This example allow undefined STCs to BYPASS security:

TSS ADDTO(STC) PROCNAME(DEFAULT)
               ACID(BYPASS)

This example associates undefined STCs with a selected pre-existing ACID U123456:

TSS ADDTO(STC) PROCNAME(DEFAULT)
               ACID(U123456)

This example forces an operator to assign the ACID and password assigned to each separate execution of STC WHOAREU:

TSS ADDTO(STC) PROCNAME(WHOAREU)
               ACID(PROMPT)

This example forces an operator to indicate who started task WHOSTRT and assigns an execution ACID of MESTRT:

TSS ADDTO(STC) PROCNAME(WHOSTRT)
               ACID(MESTRT)
               STCACT

When executed, the following prompts appear:

S STCATC1
04 TSS7152A Specify Your AccessorID/Password to Allow Use of STC=STCATC1
R 4,OPER1A/SUPER
IEE600I REPLY TO 04 IS;SUPPRESSED
05 TSS7150A SPECIFY PASSWORD FOR STC=STCATC1 ACID=STCATC1
R 5,STC
IEE600I REPLY TO 05 IS;SUPPRESSED
$HASP100 STCATC1 ON STCINRDR
IEF695I START STCATC1 WITH JOBNAME STCATC1 IS ASSIGNED TO USER STCATC1
$HASP373 STCATC1 STARTED
IEF403I STCATC1 - STARTED - TIME=17.15.59
IEF404I STCATC1 - ENDED - TIME=17.16.00

Message TSS7150A appears due to the ACID operand, assigning ACID STCATC1 to PROCNAME STCATC1. For purposes of discussion, this ACID is listed below:

ACCESSORID = STCATC1 NAME = STCATC1
TYPE = USER SIZE = 256 BYTES
FACILITY = STC
DEPT ACID = SYSDEPT DEPARTMENT = QA SYSTEMS RESOUREC DEPT
CREATED = 04/20/06 LAST MOD = 04/20/06 12:15
LAST USED = 05/17/06 17:15 CPU(XE18) FAC(STC ) COUNT(00003)
PASSWORD = STC

The correct response to TSS7150A is the password of the assigned ACID.

The message TSS7152A appears in response to the STCACT keyword on the ADD command for PROCNAME STCATC1. The response provides a user and password indication of who entered the START command.

This example provides a common ACID CTSREGN for all procedure names that begin with the characters "CTS". CTS22 is set to FAIL because it is obsolete:

TSS ADD(STC) PROCNAME(CTS*)
             ACID(CTSREGN)

TSS ADD(STC) PROCNAME(CTS22)
             ACID(FAIL)

This example console command assigns the procname CTS31 to ACID CTSREGN:

START CTS31

This example console command fails:

START CTS22

These example STC definitions use invalid generic names:

TSS ADD(STC) PROCNAME(CTS*2)
             ACID(CICSYS2)

TSS ADD(STC) PROCNAME(*)
             ACID(TOOGENR)

This example removes definitions for STC PROCNAMES:

TSS REM(STC) PROCNAME(STCATC1)

This example associates a started task for a dump processing with an ACID (use the CREATE function to define ACID OP187):

TSS ADDTO(STC) PROCNAME(PRDMP)
               ACID(OP187)

This example associates undefined STCs with a default ACID (use the CREATE function to define ACID 12347):

TSS ADDTO(STC) PROCNAME(DEFAULT)
               ACID(12347)