INGDYN
Purpose
The INGDYN command is used to display, create, or delete dynamic resources. It is also used to display templates and template details.
Syntax
Standard Parameters
- LIST
- Displays the list of templates available in the persistent data store. Display of all templates is the default.
- INFO
- Displays details of a template. You can apply the same filters as on the LIST action as long as one template is clearly identified.
- CREATE
- Creates a new dynamic resource from the specified template. You can apply the same filters as on the LIST and INFO actions as long as one template is clearly identified that has the currency indicator set to Y.
- DELETE
- Deletes one or more existing dynamic resources.
- RESOURCE
- Displays the list of resources that are created from the specified template. You can apply the same filters as on the LIST and INFO actions as long as one template is clearly identified.
- TARGET
- For information on the TARGET parameter, see TARGET Parameter.
- OUTDSN
- For information on the OUTDSN parameter, see OUTDSN Parameter.
- OUTMODE
- For information on the OUTMODE parameter, see OUTMODE Parameter.
- Filter Options:
-
When the Filter Options are used with the LIST action, the filter can identify one or multiple templates. When the Filter Options are used with the INFO, CREATE, or RESOURCE action, the filter must be precise enough to identify one unique template.
- TEMPLATE
- Specifies the name of the template(s) to be displayed (for the LIST, INFO, or RESOURCE action), or to be used to dynamically create a resource (for the CREATE action). Asterisks (*) and percentage signs (%) can be used as wildcard characters.
- TS
- Specifies the timestamp of the template(s) to be displayed (for the LIST, INFO, or RESOURCE action), or to be used to dynamically create a resource (for the CREATE action). Asterisks (*) and percentage signs (%) can be used as wildcard characters.
- Create Options:
-
- CMT
- Specifies a comment to be associated with the creation of the new resource. The maximum length is 40 characters. If OUTMODE=LINE is used and the text contains embedded blanks, the text must be enclosed in quotation marks or parentheses.
- SDESC
- Specifies a short description of the new resource. The maximum length is 40 characters. If
OUTMODE=LINE is used and the text contains embedded blanks, the text must be enclosed in quotation
marks or parentheses.
If a short description is defined in the template, it will be used by default.
- SUBSNAME
- Specifies the subsystem name of the new resource. This information is mandatory.
- SYSNAME
- Specifies the system name used to build the new resource. This information is mandatory.
- JOB
- Specifies the job name of the new resource. This information is mandatory.
Typically, the job name is explicitly defined through the resource creation panel or the command line parameter JOB.
The job name defined in the template is used as default. It serves as naming guidance when specifying the job name on the INGDYN CREATE panel.
- PROCNAME
- Specifies the procedure name of the new resource. This information is optional.
If the procedure name is defined in the template, then this name will be used as default.
If the procedure name is neither defined on the INGDYN CREATE panel, nor it is defined through the template, then the job name is used.
- GROUP
- Specifies the automation name of the application group (APG) that will host the new resource.
This information is optional.
If an APG is specified here, it must be of type SYSTEM. If the specified APG is of model 1, the new resource will have a preference value '1' defined. If the specified APG is of model 2, the new resources will have the role 'Operator' defined.
INGDYN CREATE also supports so-called extended parameters in the default SAFE. The default SAFE can be used to pass keyword parameters to INGDYN according to the following table:
Parameter Description Command Line SAFE Exit AOFEXC28 √ means a supported parameter. TEMPLATE Template name √ TS Template timestamp √ CMT Comment for the creation of the new resource √ √ √ SDESC Short description of the new resource √ √ √ SUBSNAME Name of the new resource √ √ √ SYSNAME System to create the new resource on √ √ √ JOB Job name of the new resource √ √ √ PROCNAME Procedure name of the new resource √ √ √ GROUP Name of the group to host the new resource √ √ √ PATH USS path of the new resource √ √ FILTER USS filter to uniquely identify the USS process √ √ Note:- If a parameter is given on both the command line and the SAFE, the command line takes precedence.
- If a parameter is returned by exit AOFEXC28, it overrules both the command line and the SAFE.
- If a parameter is not given at all, the value from the template is used.
- PATH and FILTER are valid only for USS resources. Use delimiters if the values contain blanks.
Here is an example to create a USS resource from REXX:
/*REXX */ safe.1 = “PATH=’/u/user1/my USS path/prog’” safe.2 = “FILTER=’-p parm1’” safe.0 = 2 ‘PIPE STEM safe. COLLECT’, ‘| NETV INGDYN CREATE TEMPLATE=USS_TEMPL SUBSNAME=MYAPPL SYSNAME=SYS1’, ‘| CONS ONLY’ - Delete Options:
-
- RESOURCE
- Specifies the resource(s) to be deleted in Automation Manager notation. Asterisks (*) and
percentage signs (%) can be used as wildcard characters for each resource qualifier. Take the resources R1/APL/SYS1 and R2/APL/SYS2 as examples:
- R%/*/*1 matches all resources (R1/APL/SYS1) with a name starting with "R" and a system ending with "1" regardless of the type.
- R2/** matches all resources (R2/APL/SYS2) with a name of "R2" regardless of the type and system.
- R** matches all resources (both) with a name starting with "R" regardless of the type and system.
- ** matches all resources (both), regardless of name, type, and system.
- VERIFY
- Specifies whether the delete process should be verified. The following specifications are valid:
- YES
- Depending on the type of the NetView task where the INGDYN command is running on, the verification is either displayed on a full screen panel or, in line mode, shown on the console. The latter is also done when OUTMODE=LINE is coded.
- WTOR
- The list of affected resources is displayed before the delete process begins. The operator is prompted to verify the list via WTOR.
- NO
- No verification is performed. VERIFY is set to NO for unattended tasks. Otherwise, it is set to YES.
The default depends on the type of task where the INGDYN command runs on.
Restrictions and Limitations
The INGDYN command can be used only when SA z/OS is initialized.
Usage
The newly created resource will be suspended from automation. You need to resume it manually. Optionally, you can use exit AOFEXC29 for programmed actions, for example, automatically resuming the new dynamic resource after it's created successfully.
The INGDYN command operates sysplex-wide. For an overview, see Overview of Commands that Operate Sysplexwide.
You can abbreviate the actions into the first letters, for example, D for DELETE.
Example: creating a new resource from NetView Console
To list the currently available templates, enter the INGDYN command on the NetView Console. The INGDYN MAIN panel as shown in Figure 1 is displayed.
INGKYDY0 SA z/OS - Command Dialogs Line 1 of 7
Domain Id . : IPUND ---------- INGDYN MAIN ----------- Date . . : 11/04/19
Operator Id : OPER Sysplex = AOCAPLEX Time . . : 07:33:48
Cmd: C Create Resource L List Resources S Show Details
CMD Name Timestamp C NumRes Description
--- -------------------- ------------------- - ------ ----------------------------------------
R#DYNCICS 2019-10-18 15:34:17 Y 2 template for CICS AOR
R#DYNIMS 2019-10-18 15:37:41 Y 0 template for IMS
R#DYNZWS 2019-10-28 14:34:58 Y 0 template for ZWS
R#DYNZWS 2019-10-10 07:49:33 N 1 template for ZWS
- The Name field shows the name of the template.
- The Timestamp field shows the date and time when the template was changed.
- The C filed indicates the currency of the template. The value Y means that this is the template currently in the configuration, while the value N means that this is an outdated template that still has resources.
- The NumRes filed displays the number of resources created from the template.
- The Description field shows the short description of the template.
- C Create a dynamic resource from the template. This is possible only for the current version.
- L List resources of the template.
- S Show details of the template.
To create a resource based on a template, specify C in the CMD column in front of the template (for example, the R#DYNCICS template) and press Enter. Then the INGDYN CREATE RESOURCE panel, as shown in Figure 2, is displayed.
INGKYDYI SA z/OS - Command Dialogs
Domain Id . : IPUND ----- INGDYN CREATE RESOURCE ----- Date . . : 11/04/19
Operator Id : OPER Sysplex = AOCAPLEX Time . . : 07:49:32
Template . . .: R#DYNCICS Timestamp : 2019-10-18 15:34:17
Version . . . .: 1.0.0
Description . .: template for CICS AOR
Comment ==>
Resource (APL)
Description ==> template for CICS AOR
Subsystem name ==> System name ==>
Job name ==> CICS1AR1 Procedure name ==> CICS1AR1
Hosting APG ==> (APG Type: SYSTEM) On this panel, specify the following fields:
- (Optional) In the Comment field, leave a comment to be associated with the creation of the resource.
- (Optional) In the Description filed, specify a description of the created resource. It defaults to the template description.
- In the Subsystem name field, specify the name of the subsystem.
- In the System name field, specify the name of the system. It is used to build the resource name. The resource can be created only on a system where the currently used template is specified.
- In the Job name field, specify the job name of the resource. It defaults the job name defined in the template.
- (Optional) In the Procedure name field, specify the name of the procedure that is used to start the resource. It defaults to the procedure name defined in the template.
- (Optional) In the Hosting APG field, specify the automation name of the system application group (APG) to host the newly created resource. The system APG and the hosted resource must be located on the same system.
After you enter these fields, press PF10 (Go). The following example message is displayed, which indicates that the resource was created successfully.
ING392I Creation was successful. Resource: TEST/APL/AOCD
On the INGLIST panel, the Sus column of the new resource has the value 'DIR', which means it's suspended directly. This is because SA z/OS initially put every new dynamic resource into a suspended state. The operator has to resume it manually.
CMD Name Type System Sus Compound Desired Observed Nature Automation Startable
--- ----------- ---- -------- --- ------------ ------------ ---------- ------ ---------- ---------
TEST APL AOCD DIR SATISFACTORY UNAVAILABLE SOFTDOWN IDLE DENIED