zowe › ims › update › program
Update an IMS application program.
Usage
zowe ims update program [name...] [options]
Positional Arguments
name...(string)- The name of the application program(s) to update. The maximum length of a program name is eight characters.
Options
--bmp-type|--bmptype(string)Specifies whether the program runs in a BMP type region or not. (N or Y).
Allowed values: N, Y
--dynamic|--dopt(string)Specifies the dynamic option (N or Y).
Allowed values: N, Y
--fast-path|--fp(string)Specifies the Fast Path option (E or N).
Allowed values: E, N
--generated-psb|--gpsb(string)Specifies the generated PSB option (N or Y).
Allowed values: N, Y
--language|--lang(string)Specifies the language interface of the program or a GPSB or defined a DOPT(Y) program as using the JAVA language (ASSEM, COBOL, JAVA, PASCAL, PLI).
Allowed values: ASSEM, COBOL, JAVA, PASCAL, PLI
--lock|-l(string)Specifies the LOCK status is to be set (ON or OFF).
Allowed values: ON, OFF
--option|-o(string)Specifies to return response lines for all resources that are processed. It is only valid with --name * (ALLRSP).
Allowed values: ALLRSP
--resident|-r(string)Specifies the resident option (N or Y).
Allowed values: N, Y
--route|--rte(array)- Specifies the region(s) to route the command.
--schedule-type|--schdtype(string)Specifies whether this application program can be scheduled into more than one message region or batch message region simultaneously (PARALLEL or SERIAL).
Allowed values: PARALLEL, SERIAL
--transaction-level-stat|--transtat(string)Specifies whether transaction level statistics should be logged (N or Y).
Allowed values: N, Y
IMS Connection Options
--host|-H(string)- The IMS Operations API server host name.
--port|-P(number)- The IMS Operations API server port.
--ims-connect-host|--ich(string)- The hostname of your instance of IMS Connect. This is typically the hostname of the mainframe LPAR where IMS Connect is running.
--ims-connect-port|--icp(number)- The port of your instance of IMS Connect. This port can be found in your IMS Connect configuration file on the mainframe.
--plex|-x(string)- The name of the IMS plex.
--user|-u(string)- The web server user name where the IMS Operations API resides.
--password|--pass(string)- The web server user password where the IMS Operations API resides.
--base-path|--bp(string)- The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.
Profile Options
--ims-profile|--ims-p(string)- The name of a (ims) profile to load for this command execution.
--base-profile|--base-p(string)- The name of a (base) profile to load for this command execution.
Base Connection Options
--reject-unauthorized|--ru(boolean)Reject self-signed certificates.
Default value: true
--token-type|--tt(string)- The type of token to get and use for the API. Omit this option to use the default token type, which is provided by 'zowe auth login'.
--token-value|--tv(string)- The value of the token to pass to the API.
Response Format Options
--response-format-filter|--rff(array)- Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.
--response-format-type|--rft(string)The command response output format type. Must be one of the following:
table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.
list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.
object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.
string: Formats output data as a string. JSON objects/arrays are stringified.
Allowed values: table, list, object, string
--response-format-header|--rfh(boolean)- If "--response-format-type table" is specified, include the column headers in the output.
Examples
Update an application program named PGM123 to execute exclusively as Fast Path:
zowe ims update program "PGM123" --fp "E"
Update all application programs beginning with ACC* to not run in a BMP type region:
zowe ims update program "ACC*" --bmptype "N"
Unlock all programs beginning with PGM* to allow scheduling:
zowe ims update program "PGM*" --lock "OFF"
Update an application program named PGM890 to execute as Fast Path routing to control regions IMS1 and IMS2:
zowe ims update program "PGM890" --fp "E" --route "IMS1 IMS2"
Unlock an application programs named XYZ1 to allow scheduling specifying optional connection parameters:
zowe ims update program "XYZ1" --lock "OFF" --user "username" --pass "pass1234" --host "localhost" --port 8080 --ich "zos1" --icp 9999 --plex "PLEX1"