Editing Service properties

Use this procedure to edit the Service properties, including EXEC, DD and template syntax program details. You can edit properties for user created Services only. You can browse BMC required Service properties, but you cannot edit them.

On the DASD MANAGER PLUS Main Menu, select Services and press Enter.
From the Services Menu panel, in the Service field, type the name of a Service, select Edit a Service Properties, and press Enter.
Warning
Important
As an alternative method, you can access the List Services panel from the Services Menu panel to edit service properties.
1. On the Services Menu panel, enter a wild card character in the Service field and press Enter.
2. On the Service List panel, type P next to a service and press Enter.
Edit Service Properties panel
DEAE ------------------------- Edit Service Properties ------------------------
Command ===>

Type Service data. Then press End.

Service . . : IKJEFT01                  Owner . . . . . : RDAPKM
Type . . . . . PROGRAM                   Vendor . . . . . : USR
Program Name . IKJEFT01 (for EXEC PGM=) Updated by . . . : RDAPKM
APF . . . . . Y    (Y/N APF authorized) Date last updated: 2022-03-04-11.09.55
Attach key . . 8        (1-8 Attach key)
Program Parm .
              .
Description .
              .

Select edit option. Then press Enter.
Program Details . .   1. DD statements
                       2. Syntax Template

On the Edit Service Properties panel, enter information into the following fields, and then press Enter:

Field name	Description
Type	Documentation field, describes the type of service Information Example PROGRAM, REPORT, COPY, LOAD, and so on
Program Name	Program name as it appears in the JCL in the PGM= keyword
APF	Indicates whether the program must run APF authorized
Attach Key	Indicates the key to use during the attach
Program Parm	Parameter information as it appears in the JHCL in the PARM= keyword The parameter list can contain symbolic variables.
Description	Description of the service
Program Details	Available edit options For this task, select 1 (DD statements).

The DD Statement List panel is displayed.

DEAE ----------------------- DD Statement List ---------      Row 1 to 2 of 2
Command ===>                                                  Scroll ===> CSR

Service: XL01COPY

For user-defined services, enter all DDs needed. For BMC and DB2 utilities, the
standard DDs are defined in the JCL Options file and in the Service Syntax, and
this list only contains special case DD additions.

C =Create   D =Delete   E =Edit   L =Like   A =After B =Before M =Move
                                                                 More:       >
Act Name      Type      Dataset Name
******************************** Top of data **********************************
    XLO1DD01 INFILE    RDAPKM.TEST.INFILE1
    XLO1DD01 INFILE    RDAPKM.TEST.INFILE2
******************************* Bottom of data ********************************

Enter DD statements as needed.
Warning
Important
For BMC Software required services, this list contains only additional DD statements that are not in the JCL product options file (POF) or syntax options.
Do not add DD statements for BMC Software required services.
Do not add a DD statement for the input (such as SYSIN). The syntax DD is named as part of the service syntax definition. The syntax DD is allocated to a job entry subsystem (JES) input stream for standard JCL. The syntax DD is allocated to a temporary data set if you run it in worklist format under AEXEMAIN.

(optional) To edit DD statements, perform the following steps:

Type E in the Act column next to the line item to be edited.The Edit DD Statement panel is displayed.
DEAE ---------------------------- Edit DD Statement ---------------------------
Command ===>
Type DD Statement data. Then press End.

Service . . : XL01COPY
DD name . . : XLO1DD01
Type . . . . . INFILE   (INFILE, OUTFILE, REPORT, PGMLIB)
Data set name RDAPKM.TEST.INFILE1
Description .

DD Statement text (free-form)
//   DISP=SHR


Restart DD Statement text (free-form)
//   DISP=OLD

On the Edit DD Statement panel, type information into the following fields:

In this field	Enter this information
DD name	ddname, which can contain symbolic variables Warning Important For DDNAMES defined for the USERDEF Service, you must edit the JCL to add the procstep to the DDNAME as follows: //procstep.ddnameDD
Type	Use INFILE for input. Use OUTFILE for output file name Use REPORT for message output. For the automation component, the type is always allocated to SYSOUT=. For AEXEMAIN, the type must be a data set. AEXEMAIN copies it to AEXPRINT. If the ddname* is SYSPRINT, the standard temporary SYSPRINT is used under AEXEMAIN and this SYSPRINT is ignored. Use PGMLIB for program library name. For the automation component or AEXEMAIN, the library is TASKLIB. For Standard JCL, the library is STEPLIB.
DSN	Data set name, which can contain symbolic variables If the data set is a PDS, you can supply a member name. The member name can contain symbolic variables.
Restart DD Statement text	JCL control card names (which can contain symbolic variables) to include in the DD statements The control cards generate as comments for generation from DASD MANAGER PLUS. With the automation component, the control cards generate on a restart. Do not use DSN= in the text because DASD MANAGER PLUS generates it automatically.

Press END to save your changes and return to the Edit Service Properties panel (see the figure, Edit Service Properties panel, above).

Edit the Syntax Template as follows:

In the Program Details field, type 2 (Syntax Template). If your user-defined service has syntaxes already defined, the Syntax List panel is displayed, skip to Step 7.If your user-defined service does not have syntaxes defined, the Create Service Syntax panel is displayed.
DEAE -------------------------- Create Service Syntax -------------------------
Command ===>

Press Enter to continue updating syntax options.

Service . . . . : XL01COPY
Syntax . . . . . .
Owner . . . . . . RDAPKM
DDName . . . . . .

Description . . .

Enter the following information, and then press Enter to enter syntax text:

In this field	Enter this information
Syntax	Name of the selected service syntax
Owner	Authorization ID of the user who created the service syntax
DDName	JCL data definition to be allocated during execution of the service The DDName must conform to standard DD naming conventions.
Description	Short explanation to help identify the service syntax

An edit session for the syntax text is displayed.

EDIT RDAPKM.T0291600.$04MAR16.$123259.$2854408 Syntax created
Command ===> Scroll ===> CSR
****** ***************************** Top of Data ******************************
'''''' DSN SYSTEM(&SSID)
'''''' -DISPLAY DATABASE(&DBNAME) SPACE(&SPNAME) LIMIT(*

Enter syntax in column 2 and then press END to save your changes.
Warning
Important
JCL Execution does not execute SQL commands in worklist format. BMCTRIG must generate SQL commands in standard JCL format.
The syntax for user-defined services can contain symbolic variables. For more information see the table of supported symbolic variables in User-defined programs or services.

If your user defined service has at least syntax already defined, the Syntax List panel is displayed. You can also access this panel by editing an entry on the Action Services List panel.

From the Service Syntax List panel, create or edit service syntax.
DEAE ---------- Service Syntax List ------- ---------         Row 1 to 1 of 1
Command ===>                                                  Scroll ===> CSR

Service . . . : XL01COPY
Default Syntax: UX0189

Select an option or change Display filter. Then press Enter. To change
the default syntax, select another syntax with the 'F' option.

B =Browse      C =Create         D =Delete       E =Edit   L =Like
P =Properties A =Action Impact V =View Syntax F =Set default syntax

Display filter
   Owner.Name . . . %.%
                                                                  More:   -   >
Act Dflt Name                                      Owner     Description
       Y UX0189                                    RDAPKM
******************************* Bottom of data ******************************
To limit your search criteria, edit the Owner.Name under Display filter. (The default value, %.%, specifies all syntaxes for the service.)
(optional) In the Act field, type F to set the default syntax for the Service.When a Service is added to a Service Action on the Service Action List panel, the default syntax is automatically set for that service. You can override the default from the Service Action List panel.
For more information, see Editing-Service-Syntax.

Editing Service properties

DASD MANAGER PLUS for DB2 12.1

On this page