@broadcom/ca7-for-zowe-cli/lib/cli/jobDefinition/items/PostJobResourceCountResource_1.definition.js

CA 7 Workload Automation Plug-in for Zowe CLI

"use strict";
/*
* Copyright (c) 2025 Broadcom.  All Rights Reserved.  The term
* "Broadcom" refers to Broadcom Inc. and/or its subsidiaries.
*
* This software and all information contained therein is
* confidential and proprietary and shall not be duplicated,
* used, disclosed, or disseminated in any way except as
* authorized by the applicable license agreement, without the
* express written permission of Broadcom.  All authorized
* reproductions must be marked with this language.
*
* EXCEPT AS SET FORTH IN THE APPLICABLE LICENSE AGREEMENT, TO
* THE EXTENT PERMITTED BY APPLICABLE LAW, BROADCOM PROVIDES THIS
* SOFTWARE WITHOUT WARRANTY OF ANY KIND, INCLUDING WITHOUT
* LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR
* FITNESS FOR A PARTICULAR PURPOSE.  IN NO EVENT WILL BROADCOM
* BE LIABLE TO THE END USER OR ANY THIRD PARTY FOR ANY LOSS OR
* DAMAGE, DIRECT OR INDIRECT, FROM THE USE OF THIS SOFTWARE,
* INCLUDING WITHOUT LIMITATION, LOST PROFITS, BUSINESS
* INTERRUPTION, GOODWILL, OR LOST DATA, EVEN IF BROADCOM IS
* EXPRESSLY ADVISED OF SUCH LOSS OR DAMAGE.
*/
Object.defineProperty(exports, "__esModule", { value: true });
exports.PostJobResourceCountResource_1Definition = void 0;
exports.PostJobResourceCountResource_1Definition = {
    name: "post-resource-count-resource_1",
    aliases: ["prcr1"],
    summary: "Add Resource Count resource to a job definition for DEFAULT_INSTANCE",
    description: "Add a Resource Count resource to the definition of a job",
    examples: [
        {
            options: "--job JOBA --schid 23 --rn RESOURCE.NAME --free F --sn JS010 ",
            description: "Creates a job named JOBA with resource name RESOURCE.NAME of free type F, step name JS010 and schedule id 23"
        }
    ],
    type: "command",
    handler: __dirname + "/PostJobResourceCountResource_1.handler",
    profile: {
        optional: ["ca7"]
    },
    options: [
        {
            name: "job",
            description: "Specifies the job name on which the indicated function is performed." +
                "\nLimits: 1 to 8 alphanumeric characters",
            type: "string",
            required: true
        },
        {
            name: "schid",
            description: "(Optional) Specifies the schedule ID (of this job) for which a user requirement is applied. A zero default cannot be specified for one connection and a nonzero schedule ID used for a subsequent connection to the same job with the same user requirement description. An attempt to make such a connection results in an error message." +
                "\nDefault: 0, which indicates that the requirement holds for all schedule IDs" +
                "\nLimits: 1 to 3 numeric characters from 0 through 999",
            type: "string",
            required: false
        },
        {
            name: "resource-name",
            aliases: ["rn"],
            description: "Specifies the resource name being connected to the job." +
                "\nLimits: 1 to 39 characters, the first character must be non-blank, and no embedded blanks",
            type: "string",
            required: true
        },
        {
            name: "resource-count",
            aliases: ["rc"],
            description: "Specifies the number of occurrences of the resource that the job uses." +
                "\nLimits: 1 to 4 numeric characters from 0 through 9999",
            type: "string",
            required: true
        },
        {
            name: "step-name",
            aliases: ["sn"],
            description: "(Optional) Specifies the resource is freed at the conclusion of the named job step." +
                "\nLimits: 1 to 8 alphanumeric characters" +
                "\nNotes:The step-name parameter applies to the first occurrence of the stepname that is encountered in the job stream. This includes any reference to the stepname embedded in a PROCThe only valid stepname would be for steps with PGM= coded, not for stepnames executing a PROCIf a job is restarted in a step after this step-name, the resource does not go through free processing until the job completesA step flush condition does not post the step-name process",
            type: "string",
            required: false
        },
        {
            name: "free",
            description: "Determines how VRM manages resource availability at job submission and job/step completion." +
                "\nValid values are:" +
                "\nA = Specifies the resource count is only decremented when the job abends" +
                "\nF = Specifies the resource count is decremented when the job completes, either successfully or unsuccessfully. If the step-name parameter is specified, the resource count is decremented when the specified step completes, either successfully or unsuccessfullyN = Specifies the resource count is not decremented when the job completes. The PRSCF command can be used to decrement the resource count. A cancel of the job also decrements the resource countY = Specifies the resource count is decremented when the job or step ends successfully. If the step-name parameter is specified, the resource count is decremented when the specified step completes successfully (does not abend)",
            type: "string",
            required: true
        }
    ]
};
//# sourceMappingURL=PostJobResourceCountResource_1.definition.js.map