Add Assignment
Purpose
This call adds an Assignment in Code Pipeline.
API Parameter List
ECIR, ASA
The ECIR Data Structure must have the values in the following table set.
ECIR Data Structure Values for Add Assignment
Parameter | Value |
|---|---|
OBJECT | ASGNMENT |
METHOD | ADD |
JCL Invocation
$DEFINE_ASA
ASA Data Structure
The ASA data area contains details required to add the Assignment. The ASA layout is described in the following table.
ASA Layout
Position | Length | Type | Description | JCL Keywords | API | JCL |
|---|---|---|---|---|---|---|
1 | 8 | CHAR | Default Application for Tasks added to this Assignment | APPLID | Mandatory | Mandatory |
9 | 8 | CHAR | Default Subapplication for Tasks added to this Assignment | SUBAPPL | Mandatory | Mandatory |
17 | 8 | CHAR | Stream Name | STRMNAME | Mandatory | Mandatory |
25 | 50 | CHAR | Description for Assignment | DESC | Optional | Optional |
75 | 4 | CHAR | Default signout level for Tasks added to this assignment | DFLTLVL | Optional | Optional |
79 | 24 | CHAR | Work Reference ID – text field for customer use | REFNO | Optional | Optional |
103 | 8 | CHAR | UserID of the Assignment Owner Defaults to UserID of caller | OWNER | Optional | Optional |
111 | 10 | CHAR | Default Release ID associated to Tasks added to this Assignment | IMPLNO | Optional | Optional |
121 | 4 | CHAR | User Tag – free form user field | USERTAG | Optional | Optional |
125 | 4 | CHAR | Assignment Prefix – not required if a specific Assignment is specified | ASGNPRF | See the note added after the table. | |
129 | 10 | CHAR | Assignment Number – returned if Prefix is specified, otherwise must be specified | PROJNO | See the note added after the table. | |
139 | 10 | CHAR | Return Value – Creation Date | OPNDATE | Optional | NA |
149 | 8 | CHAR | Return Value – Creation Time | OPNTIME | Optional | NA |
Example
This example adds a new assignment container. You must review and ensure that:
- The STEPLIB DD is only required if the runtime configuration authorized LOADLIB, default name ISPW.AUTHLINK, is not in the LINKLIST.
- The runtime JCL must be set to an appropriate value.
- The keyword values must be set appropriately.
//STEPLIB DD DISP=SHR,DSN=ISPW.AUTHLINK
//WZZOUT DD SYSOUT=*
//WORKIN DD *
$DEFINE_ASA
APPLID=PLAY
STRMNAME=PLAY
SUBAPPL=PLAY
DESC="ASSIGNMENT ADDED 0010"
DFLTLVL=DEV1
REFNO="WFF"
ASGNPRF=PLAY