Previous Topic: Update the Product TreeNext Topic: Change log4j Settings


Update Products and Product Releases

For obtaining updates for products and product releases, this command has the following format:

F jobname,APPL=UPDTCAT,USERID=user_id,PRODUCT=product_name
[,RELEASE=release_number][,TYPE=FULL|PTFS][,MODE=EXECUTE|CHECK|ATOMIC]
USERID=user_id

Defines the user who issues the command.

PRODUCT=product_name

Defines the name of the product for which you want to obtain updates.

Note: To distinguish between products whose names are not unique (they share part of the name), put product_name in single quotes. For example, PRODUCT='CA IDMS SQL OPTION - MVS' searches for the product named CA IDMS SQL OPTION - MVS and ignores CA Easytrieve Report Generator CA IDMS SQL OPTION - MVS.

RELEASE=release_number

(Optional) Defines the product release for which you want to obtain updates.

TYPE=FULL|PTFS

(Optional) Specifies the type of a product or release update to be obtained.

Note: If the type is not explicitly defined in the command syntax, the command is executed with the FULL type.

FULL

Retrieves all product packages and maintenance packages. This is the default.

PTFS

Retrieves only maintenance packages that have been released since the product release was updated last time.

MODE=EXECUTE|CHECK|ATOMIC

(Optional) Specifies the mode in which the command for obtaining updates for products and product releases is executed.

Note: When the mode is not explicitly defined in the command syntax, the command is executed with EXECUTE mode.

EXECUTE

Validates the command and executes any tasks generated based on it. This is the default.

CHECK

Validates the command, returns any errors but does not execute any tasks.

ATOMIC

Runs the command in the CHECK mode, validating the command and generating task based on it, but does not execute tasks immediately: it stores all the validated tasks and only executes them if all tasks have been validated.

Note: All found validation errors that are defined as WARNING are treated as SEVERE. Any error with a severity level of WARNING or SEVERE causes the entire command to fail.

Note: Do not change the order of the command parameters. Doing so may result in parsing errors.

Examples

Obtain Available Updates for One or Multiple Products

These examples obtain updates for all available releases of CA Panvalet:

F MSMTC,APPL=UPDTCAT,USERID=MYUSERID,PRODUCT=CA PANVALET - MVS,TYPE=FULL
F MSMTC,APPL=UPDTCAT,USERID=MYUSERID,PRODUCT=CA PANVALET - MVS

This example obtains updates for all available releases of CA Panvalet, CA Auditor for z/OS, and CA SMF Director:

F MSMTC,APPL=UPDTCAT,USERID=MYUSERID,PRODUCT=CA PANVALET - MVS, CA AUDITOR - MVS, CA SMF DIRECTOR - MVS

This example obtains updates for all available releases of CA IDMS SQL OPTION MVS and ignores updates for any products whose names contain the part CA IDMS SQL OPTION MVS:

F MSMTC,APPL=UPDTCAT,USERID=MYUSERID,PRODUCT='CA IDMS SQL OPTION MVS'

Obtain Specific Updates for One Product

This example obtains updates for releases 6.0, 11.0, and 12.0 of CA SMF Director in the CHECK mode:

F MSMTC,APPL=UPDTCAT,USERID=MYUSERID,PRODUCT=CA SMF DIRECTOR - MVS,RELEASE=6.0,11.0,12.0,MODE=CHECK

This example obtains updates for release 16.0 of CA IDMS SQL OPTION MVS and ignores updates for any products whose names contain the part CA IDMS SQL OPTION MVS:

F MSMTC,APPL=UPDTCAT,USERID=MYUSERID,PRODUCT='CA IDMS SQL OPTION MVS',RELEASE=16.0

Obtain Specific or Available Updates for Multiple Products

This example obtains updates for releases 6.0 and 11.0 of CA SMF Director and updates for all available releases of CA Panvalet in the ATOMIC mode:

F MSMTC,APPL=UPDTCAT,USERID=MYUSERID,PRODUCT=CA SMF DIRECTOR - MVS,RELEASE=6.0,11.0,PRODUCT=CA PANVALET - MVS,MODE=ATOMIC

This example obtains updates for release 12.0 of CA SMF Director, and release 14.5 of CA Panvalet:

F MSMTC,APPL=UPDTCAT,USERID=MYUSERID,PRODUCT=CA SMF DIRECTOR - MVS,RELEASE=12.0,PRODUCT=CA PANVALET - MVS,RELEASE=14.5

This example obtains only maintenance packages for release 12.1 of CA Auditor for z/OS that have been released since the product release was updated last time:

F MSMTC,APPL=UPDTCAT,USERID=MYUSERID,PRODUCT=CA AUDITOR - MVS,RELEASE=12.1,TYPE=PTFS

This example obtains only maintenance packages for all releases of CA Panvalet that have been released since the product release was updated last time:

F MSMTC,APPL=UPDTCAT,USERID=MYUSERID,PRODUCT=CA PANVALET - MVS,TYPE=PTFS

This example obtains updates for release 16.0 of CA IDMS SQL OPTION MVS, and release 16.0 of CA IDMS/DB - MVS, and ignores updates for any products whose names contain the part CA IDMS SQL OPTION MVS or CA IDMS/DB - MVS:

F MSMTC,APPL=UPDTCAT,USERID=MYUSERID,PRODUCT='CA IDMS SQL OPTION MVS',RELEASE=16.0,PRODUCT='CA IDMS/DB - MVS',RELEASE=16.0

This example obtains updates for all available releases of CA IDMS SQL OPTION MVS, and all available releases of CA IDMS/DB - MVS, and ignores updates for any products whose names contain the part CA IDMS SQL OPTION MVS or CA IDMS/DB - MVS:

F MSMTC,APPL=UPDTCAT,USERID=MYUSERID,PRODUCT='CA IDMS SQL OPTION MVS,CA IDMS/DB - MVS'