zowe › ca7 › commands › resolv🖨️

Work that is scheduled by a trigger or on-request work that is DEMANDed or RUN has no direct relationship to a base calendar and therefore does not require the use of this function.

Usage

zowe ca7 commands resolv [options]

Required Options

• --job (string)

  • example: AJOB*

    Limits selection for resolution to the jobs specified. If omitted, all job schedules are candidates for resolution. Value can be a specific job name or a generic name that identifies multiple jobs beginning with the specified characters.
    An asterisk (*) must be used to delimit the generic job name. The asterisk can appear in any of the eight positions but must immediately follow the last significant character of the job name requested.
    For example:
    AB* causes all jobs beginning with AB to be selected for resolution.
    * causes all job schedules to be selected for resolution.

Options

• --duplicateDate | --ddate (string)

  • example: NO

    Indicates whether to produce specific duplicate day messages (SRC1-137) each time that two or more schedule IDs for the same job schedule a given day.
    The default is NO unless the extended resolve message option is set in the user profile by the /PROF command.

• --oldYear | --oyr (string)

  • example: 22

    Specifies the year that is defined in the schedule member data (the value that is supplied by YEAR in the previous resolution that updated the schedule member).
    Only those candidate schedule members whose year data matches the OLDYR value are selected for resolution.
    If used, use one of the following values:
    empty: It is default, if omitted, only those schedule members that have not previously been resolved or whose schedules have expired are selected.
    yy: Indicates a specific year.
    *: Indicates all years and all schedules.

• --print (string)

  • example: YES

    Specifies whether to display a month-by-month schedule day calendar after resolution of the defined member is complete.
    If used, value must be YES or NO (default).

• --scal (string)

  • example: 22

    Value is the xx portion of the base calendar name, SCALyyxx.
    The SCAL value must also match the base calendar identifier (SCAL) specified in any SCHID of the schedule definition for the individual jobs.
    This value is used during the selection process of resolution to determine which schedule members to resolve.
    Required: No (unless JOB is omitted)
    *: Indicates all SCALs.
    xx: Indicates a specific SCAL.

• --test (string)

  • example: NO

    Indicates whether schedule members are updated because of the resolution process. YES and NO are the only allowable values.
    YES: Normal resolution occurs and all messages are printed, but no updating of the database occurs.This option can be used at a year-end or whenever a base calendar is changed to see the results of the resolution activity, without actually changing the schedule mask or affecting the current schedule process. YES is the default.
    NO: Normal resolution occurs and all messages are printed, and updating of the database occurs.

• --year (string)

  • example: 20

    Identifies the year of the base calendars against which the schedule is resolved. The value is the number that is the yy portion of the base calendar name, SCALyyxx.
    When a schedule is successfully updated, the YEAR value becomes part of the schedule data (see OLDYR). If the YEAR parameter is not specified, the current year is assumed to be the year from the system internal date and time.
    Also, if YEAR is not coded on the RESOLV, a determination is made to see whether the RESOLV is made within the period January 1 through June 30 as determined from system date and time.
    If so, the schedule is resolved against January through December of the current year. If a RESOLV is done within the period July 1 through December 31, the schedule is resolved against July 1 through December 31 of the current year and January 1 through June 30 of the next year.
    This behavior requires the existence of base calendars for calendar years involved. If a required base calendar is not available, an error message is issued. The schedule member is unresolved, unless a perpetual calendar is defined for this SCALyyXX. In that case, the calendar is generated from the PCALYYXX member in the perpetual calendar data set. YEAR is optional. If YEAR is specified, the resolution is made against January through December of the year specified.
    Default: Current year
    Limits: 2 numeric characters

CA7 Connection Options

• --host | -H (string)

  • Host name of the CA7 API service that is running on the mainframe system.

• --port | -P (number)

  • Port for the CA7 API service that is running on the mainframe system.

• --user | -u (string)

  • User name for authenticating connections to the CA7 API service that is running on the mainframe system.

• --password | --pass | --pw (string)

  • Password for authenticating connections to the CA7 API service that is running on the mainframe system.

• --base-path | --bp (string)

  • The base path for your API mediation layer instance. Specify this option to prepend the base path to all resources when making REST requests. Do not specify this option if you are not using an API mediation layer.

• --protocol | -o (string)

  • Specifies protocol to use for CA7 connection (http or https).

    Allowed values: http, https

Profile Options

• --ca7-profile | --ca7-p (string)

  • The name of a (ca7) 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

Examples

• Creates or modifies processing schedules for jobs, AJOB from CA 7:

  • zowe ca7 commands resolv --job AJOB Copy