m_jcl_select_file_sys

In the interactive mode this module allows you to select files you want to add to your JCL/PROC/SYSIN process. When this process starts via REST-API then it is silent (not visible at all) and all the input must by provided via JSON object. In this case it is necessary so specify all information needed, which means: source system and library, target system and library and check system. Source files can be specified with wildcards in dataset/member names.

Example 1 (import existing JCL members with wildcards in their names)

As interrupt parameter is specified and equals true then the process is interrupted after requested members are imported to the process by m_jcl_select_file_sys module. This allows you to open the process in interactive mode and check the result. The import element must be an object, which must contain these items:

check_system

Specifies the system where members are checked (where SmartJCL runs). It must be one of systems defined in system_mapping array.

items

Specifies members to be imported. Each of them is described by an object with these options:

source: the files to import. It must be an array where each item has SYS/DSN(MEM) format. Wildcards are allowed in member names.

target: the target library where the file should be stored in SYS/DSN format.

The example imports all members matching OPC* member mask that exist in P391D.HOS.TEST library on SYSH_ID system.

• The requested target location is P391D.HOS.JOBLIB on SYSH_ID system.

• SmartJCL analysis runs on SYSH_ID system.

• The process is interrupted after the members have been imported.

{
  "process": 250,
  "action": "JCL_NEW",
  "ignore_predprocess_status": true,
  "activity_input_data": {
    "task": {
      "t0400": {
        "interrupt": true,
        "import": {
          "check_system": "SYSH_ID",
          "items": [
            {
              "source": [
                "SYSH_ID/P391D.HOS.TEST(OPC*)"
              ],
              "target": "SYSH_ID/P391D.HOS.JOBLIB"
            }
          ]
        }
      }
    }
  }
}

Example 2 (import JCL members which are defined exactly)

• The example imports P391D.HOS.TEST(ABC) and P391D.HOS.TEST(DEF) members from SYSH_ID system.

• The requested target location is P391D.HOS.JOBLIB on SYSH_ID system.

• SmartJCL runs on SYSH_ID system.

• Once members are imported, the next tasks start automatically because interrupt=false.

{
  "process": 250,
  "action": "JCL_NEW",
  "ignore_predprocess_status": true,
  "activity_input_data": {
    "task": {
      "t0400": {
        "interrupt": false,
        "import": {
          "check_system": "SYSH_ID",
          "items": [
            {
              "source": [
                "SYSH_ID/P391D.HOS.TEST(ABC)",
                "SYSH_ID/P391D.HOS.TEST(DEF)"
              ],
              "target": "SYSH_ID/P391D.HOS.JOBLIB"
            }
          ]
        }
      }
    }
  }
}

Example 3 (import JCL members into two different target libraries)

• The example imports P391D.HOS.TEST(ABC) and P391D.HOS.TEST(DEF) and sets their target location to P391D.HOS.JOBLIB on SYSH_ID system.

• The example imports P391D.HOS.TEST(MEM1) and P391D.HOS.TEST(MEM2) and sets their target location to P391D.HOS.JOBLIB2 on SYSH_ID system.

• SmartJCL runs on SYSH_ID system.

• Once members are imported the next tasks start automatically, because interrupt=false.

{
    "process": 250,
    "action": "JCL_NEW",
    "ignore_predprocess_status": true,
    "activity_input_data": {
        "task" : { 
            "t0400": {
                "interrupt": false,
                "import": {
                    "check_system": "SYSH_ID",
                    "items": [
                        {
                            "source": ["SYSH_ID/P391D.HOS.TEST(ABC)",
                                       "SYSH_ID/P391D.HOS.TEST(DEF)"],
                            "target": "SYSH_ID/P391D.HOS.JOBLIB"
                        },
                        {
                            "source": ["SYSH_ID/P391D.HOS.TEST(MEM1)",
                                       "SYSH_ID/P391D.HOS.TEST(MEM2)"],
                            "target": "SYSH_ID/P391D.HOS.JOBLIB2"
                        },
                    ]
                }
            }
        }
    }
}

Example 4 (create members from supplied data)

• The example creates a new member, whose source lines are provided in the input JSON object in lines array.

• CommentShare feedback on the editorthe requested target location is P391D.HOS.JOBLIB(NEWMEM) on SYSH_ID system.

• CommentShare feedback on the editorSmartJCL runs on SYSH_ID system

{
    "process": 250,
    "action": "JCL_NEW",
    "ignore_predprocess_status": true,
    "activity_input_data": {
        "task" : { 
            "t0400": {
                "interrupt": true,
                "new": {
                    "check_system": "SYSH_ID",
                    "items": [
                        {
                            "member": "NEWMEM",
                            "target": "SYSH_ID/P391D.HOS.JOBLIB",
                            "lines": [
                                "//NEWMEM JOB",
                                "//EX     EXEC PGM=IEFBR14"
                            ]        
                        }
                    ]
                }
            }
        }
    }
}