@broadcom/ca7-for-zowe-cli
Version:
CA 7 Workload Automation Plug-in for Zowe CLI
137 lines • 6.82 kB
JavaScript
"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.PostDefinition = void 0;
exports.PostDefinition = {
name: "post",
aliases: ["po"],
summary: "Posts the requirement for a job",
description: "The POST command indicates to the CA Workload Automation CA 7 Edition\n" +
"system that a preexecution requirement for a job in the request queue is satisfied.\n" +
"Two categories of requirements can be satisfied, internal and external.\n" +
"The internal requirements are known within the database and CA WA CA 7 Edition controls them.\n" +
"An example of an internal requirement is the completion of another job that CA WA CA 7 Edition\n" +
"controls whose completion satisfies a requirement for a dependent job.\n" +
"The external requirements are defined in the database but not controlled by CA WA CA 7 Edition.\n" +
"A manual post must satisfy external requirements unless the requirement is cataloged in the CA WA CA 7 Edition\n" +
"catalog before the using job is scheduled into the request queue.\n" +
"This function is available through the QM.2 CPU Job Predecessors Prompt panel.",
examples: [
{
options: "--ca7Id Instance1 --ca7# 0016",
description: "The requirement for ca7 number 0016 in the request queue is satisfied on Instance1"
}
],
type: "command",
handler: __dirname + "/Post.handler",
profile: {
optional: ["ca7"]
},
options: [
{
name: "ca7Id",
description: "CA7ONL Instance",
type: "string",
required: true
},
{
name: "key",
description: "The command transaction key",
type: "string",
required: false
},
{
name: "ca7#",
description: "Indicates the job number in up to four digits, for which requirements are posted.",
type: "string",
required: false
},
{
name: "usr",
description: "(Optional) Identifies a user-defined description of a requirement to post as satisfied." +
"\nMutually exclusive with DEPJOB and DSN." +
"\nWhen used, must match the text that is used to define the requirement on the DB.6 panel or with the ADDRQ command." +
"\nLimits:" +
"\n1 to 36 alphanumeric characters",
type: "string",
required: false
},
{
name: "depjob",
description: "(Optional) Identifies a predecessor job dependency requirement to post as satisfied." +
"\nValue must be a specific job name." +
"\nMutually exclusive with DSN and USR." +
"\nIn normal situations, CA WA CA 7 Edition automatically posts this type of requirement when the predecessor job completes its execution successfully." +
"\nA manual posting is only necessary if a job defined as a requirement was not to be run," +
"\nor ran unsuccessfully and a successor job is to be run.The DEPJOB must be posted if it is not currently defined to CA WA CA 7 Edition" +
"\n (an external job)." +
"\nLimits:" +
"\n1 to 8 alphanumeric characters",
type: "string",
required: false
},
{
name: "dsn",
description: "(Optional) Identifies a data set requirement to post as satisfied." +
"\nValue can be a specific data set name or a CA WA CA 7 Edition data set number." +
"\nIf you are using a number, only the number can be specified without the DS prefix." +
"\nMutually exclusive with DEPJOB and USR." +
"\n dsname" +
"\n Indicates a specific data set name." +
"\n Limits:" +
"\n 1 to 44 alphanumeric characters" +
"\n dsnumber" +
"\nIndicates a specific data set number. Limits:" +
"\n 1 to 8 numeric characters" +
"\n",
type: "string",
required: false
},
{
name: "internal",
description: " (Optional) Valid only with DSN to indicate that the data set being posted is internal to the CA WA CA 7 Edition workload." +
"\nYES is the only acceptable value." +
"\nMutually exclusive with USR, DEPJOB, and PREQ." +
"\nIn normal situations, CA WA CA 7 Edition automatically posts requirements for internal data sets." +
"\nLimits:" +
"\nYES is the only acceptable value.",
type: "string",
required: false
},
{
name: "preq",
description: "(Optional) Valid only with DSN to identify up to 11 numeric values to include" +
"\nwith other CA WA CA 7 Edition log data logged as a result of the POST command being issued." +
"\nMutually exclusive with USR, DEPJOB, and INTERNAL." +
"\nCode values in sublist form, within parentheses." +
"\nYou can code up to 11 values that are separated by commas between the parentheses." +
"\nEach value cannot exceed 4 numeric digits." +
"\nThis optional field can be useful for logging any meaningful numbers, such as batch numbers, which can later be reviewed in the log data set." +
"\n",
type: "string",
required: false
}
]
};
//# sourceMappingURL=Post.definition.js.map