Processing Element Actions › Signin Statement

Signin Statement

►►─ SIGnin ELEment ─ element-name ─┬──────────────────────────────┬─ FROm ────►
                                   └─┬─ THRough ─┬─ element-name ─┘
                                     └─ THRu ────┘
 ►─ ENVironment ─ env-name ─ SYStem ─ sys-name ─ SUBsystem ─ subsys-name ─────►
 ►─ TYPe ─ type-name ─┬─ STAge ─ stage-id ────────┬───────────────────────────►
                      └─ STAge NUMber ─ stage-no ─┘
 ►─┬──────────────────────────────┬───────────────────────────────────────────►
   └─ WHEre ─ ¤ ─┬──────────┬─ ¤ ─┘
                 ├─┤ CCID ├─┤
                 └─┤ PRO ├──┘
 ►─┬────────────────────────────────────────────┬─ . ─────────────────────────►◄
   └─ OPTion ─ ¤ ─┬───────────────────────┬─ ¤ ─┘
                  ├─ OVErride SIGNOut ────┤
                  ├─ SIGNOut TO ─ userid ─┤
                  └─┬─ NOSearch ◄ ─┬──────┘
                    └─ SEArch ─────┘

Expansion of CCID

                                                     ┌─ , ────┐
├── CCId ─┬──────────────────────┬─┬───────────┬─ ( ─▼─ ccid ─┴─ ) ────────────┤
          └─ OF ─┬─ CURrent ◄ ─┬─┘ ├─ EQual ◄ ─┤
                 ├─ ALL ───────┤   └─ = ───────┘
                 └─ RETrieve ──┘

Expansion of PRO

                                  ┌─ , ──────────┐
├── PROcessor GROup ─┬─ EQ ─┬─ ( ─▼─ group name ─┴─ ) ─────────────────────────┤
                     └─ = ──┘

SIGNIN ELEMENT element-name

Indicates the element(s) to be signed in. Code the required syntax and enter the appropriate element name. In addition, you can use a name-mask with the element name.

THROUGH (THRU) element-name

Indicates that a range of elements should be signed in, beginning with the element coded in the SIGNIN ELEMENT statement, up to and including the element specified in this statement. You can use a name-mask with the element name.

FROM ENVIRONMENT env-name

SYSTEM system-name

SUBSYSTEM subsys-name

TYPE type-name

STAGE stage-id

STAGE NUMBER stage-no

The FROM clause indicates the location of the element being signed in. CA Endevor SCM uses both the FROM clause in an action and any preceding SET FROM clause to determine the "from" criteria for that action.

• A FROM clause in an action overrides values in a SET FROM clause that precedes the action.
• If the SET FROM clause contains values that are not included in the FROM clause, CA Endevor SCM uses these values.

You must specify an environment, system, subsystem, type, and stage. The environment name must be explicit. You can use a name-mask with the system, subsystem, type, and stage. The stage specification can be either one of the following:

• STAGE ID-Enter a single alphanumeric stage identifier.
• STAGE NUMBER-Enter either 1 or 2.

If you use a name-mask with the stage, CA Endevor SCM begins searching for the specified element(s) in Stage 1 of the current environment, and signs in the first element that matches the specified element name, regardless of its location, version or level.

WHERE

Use WHERE clauses to further qualify element selection criteria. CA Endevor SCM uses both the WHERE clause in an action and any preceding SET WHERE clause to determine the "where" criteria for that action.

• A WHERE clause in an action overrides values in a SET WHERE clause that precedes the action.
• If the SET WHERE clause contains values that are not included in the WHERE clause, CA Endevor SCM uses these values.

WHERE CCID OF ccid -Limits the processing to those elements that match one of the supplied CCIDs. You can use a name-mask in this field.

• CURRENT-Tells CA Endevor SCM to look through the CCID fields in the MCF (Master Control File) to find a specified CCID(s). This is the default.
• ALL-Tells CA Endevor SCM to search both the Master Control File and the SOURCE DELTA levels for a specified CCID(s). If you have ACM, CA Endevor SCM also searches the COMPONENT LIST DELTA levels for the specified CCID(s). If the element is sourceless, the source element delta level CCID checks are not done.
• RETRIEVE-Tells CA Endevor SCM to use the CCID in the Master Control File RETRIEVE CCID field.

If you need to select elements identified under more than one CCID, you can specify multiple CCIDs by enclosing the CCIDs with parentheses and separating them with commas. The CCIDs may extend over multiple lines if necessary. The following examples illustrate the use of this clause.

Example 1: WHERE CCID OF CURRENT (PROJ__1, PROJ__2, PROJ__4)
Example 2: WHERE CCID OF ALL (PROJ__V)

WHERE PROCESSOR GROUP group name-This clause allows you to select elements according to a specified processor group. You can use a name-mask when specifying the processor group name.

If you need to select elements identified under more than one processor group, you can specify multiple distinct processor group selectors by enclosing the processor groups with parentheses and separating them with commas. The processor groups may extend over multiple lines if necessary.

The following examples illustrate the use of this clause.

Example 1: WHERE PROCESSOR GROUP (COBVS, COBII)
Example 2: WHERE PROCESSOR GROUP (COBV)

OPTIONS

OPTIONS clauses allow you to further specify action requests.

OVERRIDE SIGNOUT-If the element has been signed out to a person other than yourself, you must code this option in order to perform this action. Use OVERRIDE SIGNOUT with caution to avoid regressing changes made by another user.

SIGNOUT TO-Enables you to sign out or reassign an element at either stage to another user. If you have an element signed out to your user ID, you can use this option to reassign that element to the other user.

SEARCH/NOSEARCH-The NOSEARCH option tells CA Endevor SCM to restrict its search to the current environment. The default is NOSEARCH.

Code SEARCH to tell CA Endevor SCM to look for the element to be signed in along the map, if it is not in the current environment.

Example: Signin SCL

This SCL signs in all COBOL elements that begin with “PAYRPT*” at Stage 1 and are associated with CCID REQ#39934.

SIGNIN ELEMENT 'PAYRPT_'
FROM ENVIRONMENT 'PROD'
SYSTEM 'PAYROLL'
SUBSYSTEM 'REPORTS'
TYPE 'COBOL'
STAGE NUMBER 1

WHERE CCID OF CURRENT = REQ#39934.