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.

• --cert-file (local file path)

  • The file path to a certificate file to use for authentication

• --cert-key-file (local file path)

  • The file path to a certificate key file to use for authentication

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" Copy

• Update all application programs beginning with ACC* to not run in a BMP type region:

  • zowe ims update program "ACC*" --bmptype "N" Copy

• Unlock all programs beginning with PGM* to allow scheduling:

  • zowe ims update program "PGM*" --lock "OFF" Copy

• 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" Copy

• 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" Copy