ASG-PRO/JCL Plug-in for Eclipse IDE

ASG-PRO/JCL Plug-in for Eclipse IDE

User GuideVersion: 3.5

Publication Date: July 2021

©2021 ASG Technologies Group, Inc. All rights reserved.

The information contained herein is the confidential and proprietary information of ASG Technologies Group, Inc. Unauthorized use of thisinformation and disclosure to third parties is expressly prohibited. This technical publication may not be reproduced in whole or in part, by anymeans, without the express written consent of ASG Technologies Group, Inc.

All names and products contained herein are the trademarks or registered trademarks of their respective holders.

ASG Technologies Worldwide Headquarters Naples Florida USA | asg.com | [email protected]

708 Goodlette Road North, Naples, Florida 34102 USA Tel: 239.435.2200 Fax: 239.263.3692 Toll Free: 800.932.5536 (USA only)

ContentsPreface iii

About this Publication iii

Worldwide Customer Support iii

ASG Customer Care Expert Solution Services Portal (ACCESS) iii

Product Support Policy iv

ASG Documentation/Product Enhancements iv

ASG-PRO/JCL Plug-in for Eclipse IDE 1

Overview 2

Installation 3

Installation Requirements 3

Installing ASG-PRO/JCL Plug-in 3

Verifying the Installation 9

Verifying the z/OSMF Configuration 11

Step to verify z/OSMF Configuration 11

References: 12

Verifying the Liberty Server Configuration 13

Step to Verify Liberty Server for ASG-PRO/JCL REST Services 13

User Interface 15

Connecting to z/OS and ASG-PRO/JCL 24

Setting the JCL Scan Options 29

Input Type 29

Run-Time Settings (RTS) 29

First PROCLIB 29

JCL Manipulation Program (JMP) 29

Schedulers 29

Setting the Remote Scan Options 34

Run-Time Settings (RTS) 34

First PROCLIB 34

JCL Manipulation Program (JMP) 34

Schedulers 34

Setting the Reformat Options 38

Working with z/OS Datasets 43

Displaying Datasets 43

i

Editing and Saving Datasets 45

Refreshing Datasets 47

Working with Local Files 48

Displaying Local Files 48

Editing and Saving Local Files 54

Validating JCL 56

Scan JCL 56

Scan and submit JCL 58

Scan JCL on Remote Machine 61

Scan Multiple JCL Members 64

Scan Multiple JCL Members Using Selection List Directory 68

Reformatting JCL 75

Reports 78

Markers 82

Left-margin Markers 82

Right-margin Markers 83

Show or Hide Markers 84

Keyboard Shortcuts 89

Customizing Keyboard Shortcuts 89

Uninstallation 92

ii

ASG-PRO/JCL Plugin for Eclipse User Guide

PrefaceThis documentation describes how to use our main ASG product ASG-PRO/JCL.

About this PublicationThis documentation describes how to use the different modules that form the ASG product ASG-PRO/JCL.

Worldwide Customer SupportASG provides support throughout the world to resolve questions or problems regarding installation, operation, or use ofour products. ASG provides all levels of support during normal business hours and emergency support during non-business hours.

You can access support information from ASG’s Support page.

ASG Third-party Support. ASG provides software products that run in a number of third-party vendor environments.Support for all non-ASG products is the responsibility of the respective vendor. In the event a vendor discontinuessupport for a hardware and/or software product, ASG cannot be held responsible for problems arising from the use ofthat unsupported version.

ASG Customer Care Expert Solution Services Portal (ACCESS)The ACCESS Portal provides online support. Log on to the portal with the following information:

Email ID = NNNNNNNNN

Site Password = XXXXXXXXXX

where:

NNNNNNNNN is your email ID supplied by ASG Product Distribution.

XXXXXXXXXX is your unique site password supplied by ASG Product Distribution.

If you do not have your logon information, contact your local support center. This table outlines the support responsetimes you can expect:

Severity MeaningExpected Support ResponseTime

1 Production down, critical situation Within 30 minutes

2 Major component of product disabled Within 2 hours

3 Problem with the product, but customer has work-aroundsolution

Within 4 hours

4 “How-to” questions and enhancement requests Within 4 hours

iii

Preface

Product Support PolicyASG fully supports the current release and one previous release of each of its products. ASG will temporarily support anolder release, for up to six months, to provide time for you to upgrade.

After programming support for a product release is withdrawn, ASG will no longer supply new fixes for problems noraccept enhancement requests for that release. When a vendor announces the end of support for system software or ahardware configuration on which ASG products rely, ASG will make a similar announcement regarding the support plansfor its products. ASG’s support for problems affected by system software release levels will terminate when the vendorno longer supports their hardware or software.

Announcements regarding support plans for various products can be found on ASG’s Web site.

ASG Documentation/Product EnhancementsUse ASG’s contact form to submit your product and documentation suggestions. Ensure that you include the name ofthe ASG product you are using.

iv


https://www.asg.com/en/Contact-Us.aspx

ASG-PRO/JCL Plug-in for Eclipse IDEThis documentation introduces the features and benefits of ASG-PRO/JCL Plug-in, explains how to install, and executethe product in Eclipse environment.

It consist of following topics:

n Overview

n Installation

n User Interface

n Connecting to z/OS and ASG-PRO/JCL

n Setting the JCL Scan Options

n Setting the Remote Scan Options

n Setting the Reformat Options

n Working with z/OS Datasets

n Working with Local Files

n Validating JCL

n Reformatting JCL

n Reports

n Markers

n Keyboard Shortcuts

n Uninstallation

1

ASG-PRO/JCL Plug-in for Eclipse IDE

OverviewWhat is PRO/JCL?

PRO/JCL is a comprehensive Job Control Language (JCL) management tool that provides JCL validation, reformatting, andstandards enforcement. It is designed to help developers operate a streamlined JCL environment on the z/OSmainframe.

What is PRO/JCL Plug-in?

PRO/JCL Plug-in is an Eclipse plug-in that strategically integrates the mainframe capabilities of ASG-PRO/JCL into adeveloper’s DevOps user interface. The plug-in provides JCL management tasks with mainframe application workflow inan intuitive user interface. The simple interface provides developers to seamlessly initiate JCL integrity, verification, andreporting.

Features of ASG-PRO/JCL Plug-in:

l Offers a modern and easy-to-use User Interface (UI) to interact with the z/OS system.

l Evaluates JCLs for any syntax errors.

l Validates JCLs on remote machine.

l Validates multiple JCLs.

l Validates multiple JCLs in a user-defined order.

l Enforces site-specific JCL standards.

l Restructures JCL into a standard and easy-to-read format.

l Submits jobs to the mainframe for execution.

l Provides effective reporting facility.

l Includes RESTful web services API to automate ASG-PRO/JCL scans in a DevOps toolchain environment.

This document assumes that the user:

l has installed ASG-PRO/JCL and running on a supported z/OS system.

l has authorization to access resources on the z/OS system.

l is familiar with the functions implemented in ASG-PRO/JCL. If you are new to ASG-PRO/JCL, refer to ASG-PRO/JCL® 3.5.0 Documentation.

2


https://docs.asg.com/op_pjm_3.5/home.htm

https://docs.asg.com/op_pjm_3.5/home.htm

InstallationThis topic contains instructions for installing ASG-PRO/JCL Plug-in. These instructions include product requirements,installing the product, and verifying the installation.

Installation RequirementsBefore you install PRO/JCL Plug-in, verify that the following requirements are met:

l ASG-PRO/JCL Version 3.5.0 must be installed in the z/OS system. This topic does not explain the installationprocedure for ASG-PRO/JCL. See ASG-PRO/JCL Installation for information on installing ASG-PRO/JCL.

l Latest monthly cumulative service for ASG-PRO/JCL must be applied. Visit ACCESS Portal: https://access.asg.comto verify any monthly maintenance apply to this product release.

l Install and Configure IBM Liberty Profile Server to enable ASG-PRO/JCL REST Services. For details on installingLiberty server see the Installer Reference Guide section for guides on installing the ASG-PRO/JCL REST Services.For more information about Liberty Servers z/OS installation requirements see IBM Installing Liberty.

l User must have a TSO user ID defined to the mainframe system.

l User's TSO ID must be able to access and use ASG-PRO/JCL under ISPF.

l Eclipse IDE version 2018-06 or higher must be installed. Eclipse IDE is an open-source software and it can bedownloaded at no charge from https://www.eclipse.org/downloads/

l Java Runtime Environment (JRE) must be installed.o You can install JRE from OpenJ9: https://www.eclipse.org/openj9/o You can install JRE from Oracle: https://www.java.com/en/download/manual.jsp

l IBM z/OS® Management Facility (z/OSMF) Version 2.4 must be installed and running before using ASG-PRO/JCLPlug-in. User must have read and write access to z/OSMF. To obtain read or write access, contact your systemadministrator. To verify if z/OSMF is configured as per ASG-PRO/JCL Plug-in requirements, follow the procedurein Verifying the z/OSMF Configuration.

Installing ASG-PRO/JCL Plug-inFollow these instructions to install the ASG-PRO/JCL Plug-in after you download the product files.

To install ASG-PRO/JCL Plug-in:

1. Start Eclipse.

2. From the menu, select Help >Install New Software....

3

Installation

https://docs.asg.com/op_pjm_3.5/pjmig/main_page.htm

https://access.asg.com/

https://docs.asg.com/op_pjm_3.5/pjmqr/installer_reference_guide.htm

https://www.ibm.com/support/knowledgecenter/en/SSEQTP_liberty/com.ibm.websphere.wlp.doc/ae/twlp_inst_top.html

https://www.eclipse.org/downloads/

https://www.eclipse.org/openj9/

https://www.java.com/en/download/manual.jsp

3. In the Install dialog, click Add....

4


4. In the Add Repository dialog, enter a Name for the repository and click Archive....

5. In the Repository archive dialog, browse to select the ZIP file containing the install files, and click Open.

5

Installing ASG-PRO/JCL Plug-in

6. In the Add Repository dialog, click Add.

The ASG z/OS Application Development category appears in the Name area.

7. Select the ASG z/OS Application Development category and make sure that ASG-PRO/JCL DevelopmentEnvironment feature is selected.

8. Click Next.

6


9. Review the install items and click Next.

10. Review the license and select I accept the terms of license agreement.

7

Installing ASG-PRO/JCL Plug-in

11. Click Finish. You may receive a security warning. Click Install anyway to continue with the installation.

12. When the installation is complete, you are prompted to restart the Eclipse application. Click Restart Now.

8


Verifying the InstallationFollow the instructions in this section to verify whether the ASG-PRO/JCL Plug-in is installed successfully or to findwhether the plug-in is already installed.

To verify that the PRO/JCL Plug-in is installed:

1. Start Eclipse.

2. From the menu, select Help > About Eclipse IDE.

3. In the About Eclipse IDE dialog, click Installation Details.

9

Verifying the Installation

4. In the Installed Software tab, you should see ASG-PRO/JCL Development Environment in the list of installedsoftware. This indicates that PRO/JCL Plug-in has been installed.

10


You can check the Installation History tab (Help > About Eclipse IDE > Installation Details >Installation History) for information on when a feature is installed.

Verifying the z/OSMF ConfigurationIBM z/OS® Management Facility (z/OSMF) must be installed and configured before using ASG-PRO/JCL Plug-in. This topicprovides instructions to verify if z/OSMF is configured as per ASG-PRO/JCL Plug-in requirements.

This section does not explain the z/OSMF configuration procedure. See Configuring z/OSMF in IBMKnowledge Center for more information.

Step to verify z/OSMF Configurationl Verify if z/OSMF server is running

11

Verifying the z/OSMF Configuration

https://www.ibm.com/support/knowledgecenter/SSLTBW_2.3.0/com.ibm.zos.v2r3.izua300/IZUHPINFO_PartConfiguring.htm

Issue the console command /D A,IZU* in the command line and check if the started tasks jobs, IZUANG1and IZUSVR1, are running. If the jobs are not active, issue /S IZUANG1 and /S IZUSVR1 commands toactivate.

l Verify if z/OSMF REST services are enabled

Open a web browser to z/OS system (host name and port) and add the following REST call to the URL: GET

/zosmf/restjobs/jobs. You should see the list of the jobs that are submitted from your user ID.

l Verify if z/OSMF data set and file REST services are enabled

See if the job IZURFSEC (available in the sample jobs package) is submitted and completes with the returncode '0000'. To verify if services are running, issue a REST service request. See List the z/OS data sets in IBMKnowledge Center for syntax on how to issue a request.

The job IZUSVR1 shows the actual REST services that are running in z/OSMF. PRO/JCL Plug-in requires bothrestjobs and restfiles services. To make sure that these services are available, check the output (STDOUT)files of IZUSRV1 job, and see if it contains a message that looks like:

CWWKT0016I: Web application available (default_host): https://<your-zosmf-url>:<zosmf-port>/zosmf/<service>/

where <service> is a REST service name.

For more assistance work with your administrator.

l Verify access to z/OSMF

1. In a browser, open the URL: https://<hostname>:<port>/zosmf/

Where:

hostname is the hostname or IP address of the system in which z/OSMF is installed

port is the secure port for the z/OSMF configuration

2. Enter the z/OS USER ID that was used to configure z/OSMF

3. Enter the z/OS PASSWORD associated with the z/OS user ID.

4. Click LOGIN.

The Welcome page of IBM z/OS Management Facility is displayed. This confirms that you are authenticatedto access z/OSMF.

References:l What setup is needed for z/OSMF - https://www.ibm.com/support/knowledgecenter/SSLTBW_

2.3.0/com.ibm.zos.v2r3.izua300/IZUHPINFO_WhatSetupIsNeeded.htm

l Software prerequisites for z/OSMF - https://www.ibm.com/support/knowledgecenter/en/SSLTBW_2.2.0/com.ibm.zos.v2r2.izua300/IZUHPINFO_SoftwarePrereqs.htm

l Security configuration requirements for z/OSMF - https://www.ibm.com/support/knowledgecenter/SSLTBW_2.3.0/com.ibm.zos.v2r3.izua300/izuconfig_SecurityStructuresForZosmf.htm

l Configuring z/OSMF - https://www.ibm.com/support/knowledgecenter/SSLTBW_2.3.0/com.ibm.zos.v2r3.izua300/IZUHPINFO_PartConfiguring.htm

12


https://www.ibm.com/support/knowledgecenter/SSLTBW_2.3.0/com.ibm.zos.v2r3.izua700/IZUHPINFO_API_GetListDataSets.htm

https://www.ibm.com/support/knowledgecenter/SSLTBW_2.3.0/com.ibm.zos.v2r3.izua300/IZUHPINFO_WhatSetupIsNeeded.htm

https://www.ibm.com/support/knowledgecenter/SSLTBW_2.3.0/com.ibm.zos.v2r3.izua300/IZUHPINFO_WhatSetupIsNeeded.htm

https://www.ibm.com/support/knowledgecenter/en/SSLTBW_2.2.0/com.ibm.zos.v2r2.izua300/IZUHPINFO_SoftwarePrereqs.htm

https://www.ibm.com/support/knowledgecenter/en/SSLTBW_2.2.0/com.ibm.zos.v2r2.izua300/IZUHPINFO_SoftwarePrereqs.htm

https://www.ibm.com/support/knowledgecenter/SSLTBW_2.3.0/com.ibm.zos.v2r3.izua300/izuconfig_SecurityStructuresForZosmf.htm

https://www.ibm.com/support/knowledgecenter/SSLTBW_2.3.0/com.ibm.zos.v2r3.izua300/izuconfig_SecurityStructuresForZosmf.htm



Verifying the Liberty Server ConfigurationIBM Liberty Server for z/OS must be installed and a Liberty server for ASG-PRO/JCL REST Services must be configuredbefore using ASG-PRO/JCL Plug-in. This topic provides instructions to verify if the Liberty server for ASG-PRO/JCL RESTServices is ready as per the ASG-PRO/JCL Plug-in requirements.

This section does not explain the Liberty Server for ASG-PRO/JCL REST Services configurationprocedure. See Installer Reference Guide for more information.

A Liberty server instance may be started as a z/OS started task or started from the z/OS UNIX shell. To operate Libertyservers as z/OS started tasks, BBGZSRV by default would be the started task name.

When a Liberty server seeks to use z/OS authorized services, BBGZANGL by default is required. ASG-PRO/JCL RESTServices does not require a Liberty angel process to be setup.

For more information on the various options for configuring and starting a Liberty runtimeenvironment on the z/OS, see the IBMWebSphere Application Server for z/OS Liberty.

Step to Verify Liberty Server for ASG-PRO/JCL REST Servicesl Verify if Liberty server is running

Issue the console command /D A,BBGZSRV* in the command line and check if one or more started tasksBBGZSRV* are running. If you are not using BBGZSRV* sample proc, substitute this name with the name of the“JCL Start proc name” dedicated to ASG-PRO/JCL REST Services.

l Start a Liberty server

If started task BBGZSRV* or the name of the “JCL Start proc name” dedicated to ASG-PRO/JCL REST Services isnot running you need to start it. The following example shows the command that you would use to start aLiberty server configured for ASG-PRO/JCL REST Services named “pjmrest” using the sample bbgzsrv proc:

START BBGZSRV.PJMREST,PARMS=‘pjmrest’

The following example shows the command that you would use to stop a ASG-PRO/JCL REST Server (note: z/OSSTART command syntax of “S membername[.identifier]”, was used to identify pjmrest as the name identifyingthe task to be started, so you can issues commands against this task)

P PJMREST

l Review the messages of the Liberty server. If ASG-PRO/JCL REST Services were successfully started thesemessages would be logged to the output STDOUT DD.

The following message verifies that PRO/JCL REST Services is up and running:CWWKF0011I: The pjmrest server is ready to run a smarter planet.

13

Verifying the Liberty Server Configuration

https://docs.asg.com/op_pjm_3.5/pjmqr/installer_reference_guide.htm

https://www.ibm.com/support/knowledgecenter/en/SS7K4U_liberty/as_ditamaps/welcome_liberty_zos.html

Launching pjmrest (WAS FOR Z/OS 19.0.0.12/wlp-1.0.35.cl191220191120-0300) on IBM J9 VM,version 8.0.6.0 - pmz6480sr6-20191107_01(SR6) (en_US)[AUDIT ] CWWKE0001I: The server pjmrest has been launched.[AUDIT ] CWWKZ0058I: Monitoring dropins for applications.[AUDIT ] CWWKT0016I: Web application available (default_host):http://mvssyse.asg.com:49080/api/docs/[AUDIT ] CWWKT0016I: Web application available (default_host):http://mvssyse.asg.com:49080/api/explorer/[AUDIT ] CWWKT0016I: Web application available (default_host):http://mvssyse.asg.com:49080/projcl/[AUDIT ] CWWKZ0001I: Application projcl started in 0.556 seconds.[AUDIT ] CWWKF0015I: The server has the following interim fixes active in the runtime:PH19989,PH19528. For a full listing of installed fixes run: productInfo version --ifixes[AUDIT ] CWWKF0012I: The server installed the following features: [distributedMap-1.0,el-3.0, jaxrs-2.1, jaxrsClient-2.1, jndi-1.0, jsonp-1.1, jsp-2.3, openapi-3.0, servlet-4.0,ssl-1.0, zosSecurity-1.0].[AUDIT ] CWWKF0011I: The pjmrest server is ready to run a smarter planet. The pjmrestserver started in 3.358 seconds.[AUDIT ] CWPKI0820A: The default keystore has been created using the 'keystore_password'environment variable.ProJCL configuration processed: started task 'DSSISTC ', address 'mvssyse.asg.com', port1265.

Sample STDOUT DD Output

14


User InterfaceThis topic describes about the commonly used interface elements that are required when using the PRO/JCL Plug-infunctionalities. It also provides information on how to view these elements when not displayed in the workbench.

Menu BarTheMenu Bar contains menus and menu options that are used to perform a task. PRO/JCL commands are displayed asadditional options in the Edit menu. However, you must be connected to PRO/JCL's server before running the PRO/JCLcommands. Some options in the menu bar are available only when a file is active in the JCL Editor.

ToolbarThe Toolbar provides quick access to tasks that are commonly performed by a user. PRO/JCL commands are displayed asbuttons on the toolbar. However, you must be connected to PRO/JCL's server before running the PRO/JCL commands.Some options on the toolbar are available only when a file is active in the JCL Editor.

z/OS Navigator Viewz/OS Navigator view displays datasets that are fetched from z/OS. The datasets are displayed under a High-LevelQualifier (HLQ) in a tree-like structure. For more information about displaying datasets, refer to Displaying Datasets.

z/OS Navigator View consists of following icons:

15

User Interface

Icon Name Description

Add High Level Qualifier Fetches datasets from the z/OS system and displays under thespecified HLQ. See Working with z/OS Datasets.

Connect to z/OS Establishes connection to z/OS system. See Connecting to z/OSand ASG-PRO/JCL.

Refresh View Refreshes the list of datasets displayed. See RefreshingDatasets.

Validate Validates multiple JCLs. See Scan Multiple JCL Members

Create Selection List Creates a new selection list. See Scan Multiple JCL MembersUsing Selection List Directory.

Selection List DirectoryDisplays all the selection lists that are available in the PRO/JCLserver. See Scan Multiple JCL Members Using Selection ListDirectory.

To display z/OS Navigator view:

1. From the menu, selectWindow > Show View > Other....

2. In the Show View dialog, do one of the following:

16


l Enter z/OS Navigator in the type filter text box.

l Locate and expand the JCL folder.

3. Double-click on z/OS Navigator or select z/OS Navigator and click Open.

Status BarThe Status Bar displays the z/OS connection status.

The z/OS connection status is shown only when the z/OS Navigator view is active.

After establishing the connection to z/OS and PRO/JCL server, the status bar displays the following message:

Connected to <host address or IP address of the z/OS system>:<port number of the host machine on which the PRO/JCLREST API service is running> l PRO/JCL Release R<version of the ASG-PRO/JCL it is connected>

17

User Interface

When the connection is lost or when the session is disconnected from z/OS, the status bar display the message:Disconnected from z/OS.

JCL EditorThe JCL Editor is typically used to view, edit, save and validate a JCL file. You can view more than one file in the editorarea, but only one can be active at a time. Tabs in the editor area indicate the names of files that are currently open forediting. Some options in the menu bar and toolbar are available only when a file is active in the JCL Editor.

18


Problems ViewProblems view displays the list of problem messages that are identified in a JCL file. Generally, this view is automaticallydisplayed when you scan a file. For more information about Problems view, refer to Reports.

To display Problems view:

n From the menu, selectWindow > Show View > Problems.

19

User Interface

JCL Scan ViewJCL Scan view displays the scanned report of a JCL file. This report is similar to the PRO/JCL's Structured JCL Report (SJL).For more information about JCL Scan view, refer to Reports.

20


To display JCL Scan view:

1. From the menu, selectWindow > Show View > Other....

2. In the Show View dialog, do one of the following:

l Enter JCL Scan in the type filter text box.

l Locate and expand the JCL folder.

21

User Interface

3. Double-click on JCL Scan or select JCL Scan and click Open.

PRO/JCL Console ViewPRO/JCL Console view displays the output of a process performed in PRO/JCL Plug-in. The console displays the outputmessages in two different colors: Green for the success messages and red for the error messages.

To display PRO/JCL Console view:

1. From the menu, selectWindow > Show View > Console.

22


2. In Console dialog, click Open Console icon ( ) and select PRO/JCL Console.

23

User Interface

Connecting to z/OS and ASG-PRO/JCLThis topic explains how to establish the connection between the ASG-PRO/JCL Plug-in and z/OS system. Connection toz/OS is essential to view the z/OS resources and perform operations such as JCL editing, reformatting, validation, andexecution.

If you are a first time user, then you must create a connection profile that includes information about the z/OS systemand ASG-PRO/JCL.

To connect to z/OS:

1. Select (Connect to z/OS) icon from the z/OS Navigator pane.

The Connect to z/OS dialog appears.

24


2. Select System Name from the list of connection profiles.MVS User ID is auto-populated on selecting the systemname.

Initially, the System Name is empty. Create a new connection profile to display your profile in theSystem Name list. See the sub-topic: To create a connection Profile for more information.

3. Enter Password and click Connect.

If logon is successful, the Connect to z/OS dialog is closed and the connection status along with the version ofthe PRO/JCL is displayed in the status bar. Else, a self-explanatory error message appears in the Connect toz/OS dialog.

To create a Connection Profile:

1. Do either of the following to navigate to the PRO/JCL preference page:

l From the z/OS Navigator pane, select (Connect to z/OS) icon. In the Connect to z/OS dialog, clickManage Profiles.

l From theWindowmenu, select Preferences. In the Preferences dialog, select ASG > PRO/JCL.

25

Connecting to z/OS and ASG-PRO/JCL

2. Do the following to create a new system name:

a. Click Add....The Add System Name dialog appears.

b. Enter a name for the new connection profile and click OK.

The given system name appears in the PRO/JCL preference page.

3. In the Connection Profile tab fill the following details:

26


Field Name Description

Host URL or IPAddress

Enter host address or IP address of the z/OS system.

Port Number forz/OSMF

Enter port number of the host machine on which the z/OSMF REST APIservice is running.

Port Number forPRO/JCL

Enter port number of the host machine on which the PRO/JCL REST APIservice is running.

MVS User ID Enter User ID for logging on to the z/OS system.

4. Click Apply to save the scan options or click Apply and Close to save the scan options and return to the Connectto z/OS dialog.

To update a Connection Profile:

1. In the PRO/JCL preference page, select the System Name that you like to edit and update the details.

2. Click Apply to save the connection profile or click Apply and Close to save the connection profile and return tothe Connect to z/OS dialog.

27

Connecting to z/OS and ASG-PRO/JCL

After updating the connection profile, save the changes and reconnect to ASG-PRO/JCL using theConnect to z/OS dialog to establish connection with updated details.

To delete a Connection Profile:

1. In the PRO/JCL preference page, select the System Name that you like to delete and click Delete.

2. In the confirmation dialog, click OK. Your connection profile is deleted from the System Name list.

The connection profile details, scan options and reformat options that are saved in the SystemName will be lost, so make sure before you delete it.

28


Setting the JCL Scan OptionsThis topic explains how to set scan options that are used when validating JCLs. Similar to ASG-PRO/JCL, the ASG-PRO/JCLEclipse Plug-in allows you to specify some options that are used when validating the JCLs. You can set the followingoptions in ASG-PRO/JCL Plug-in:

Input TypeThe Input type option is similar to the Processing Mode parameter that is available in ASG-PRO/JCL Validation. Thisoption notifies PRO/JCL how to interpret the statements of the input file. When PRO/JCL encounters the specified inputtype statements in the input JCL, it validates whether the statements are syntactically correct.

Run-Time Settings (RTS)RTS is a set of predefined run-time settings that control how PRO/JCL:

l Validates JCL and control statement members.

l Simulates MVS and non-IBM product functions (such as schedulers, security, and so on).

l Generates the Structured JCL Listing (SJL) report from the members it scans.

The run-time settings are defined in the RTS members which are stored in the Product Control File (PC File). The RTSmembers are created by the PRO/JCL system administrator. Users cannot create or edit the members but can select amember that is defined by the administrator. A default RTS member is available in the PC File named as DEFAULT. Thismember can be used by all users. For more information on RTS, see ASG-PRO/JCL's System Administration Document.

First PROCLIBWhen validating JCL, it might be necessary to specify a PROC library to be searched before any other libraries. The ScanOptions tab provides a First PROCLIB field for this purpose. When this field is set, then PRO/JCL will look for the PROCand INCLUDE members used in the current file in this library first before searching other libraries. The only type oflibrary supported in this release is PDS.

JCL Manipulation Program (JMP)JMP is a set of defined rules that facilitate the automation of JCL change and site-specific standards enforcement tasks.These programs are custom-written REXX programs utilizing JMPAPI, RLAPI, and SYS functions. Sample JMP programsare available in the SYSEXEC library in the ASG-PRO/JCL started task. For a detailed introduction to PRO/JCL's JMPfacility, see ASG-PRO/JCL JMP User Information.

SchedulersA scheduler is a software tool that automates and controls a job execution when certain criteria are met. Generally, ascheduler is integrated with an application to handle the process of job execution. When jobs are executed using ascheduler, it allows the JCL to contain environmental variables, which must be resolved at the time of job submission.ASG-PRO/JCL supports a wide range of schedulers and it also resolves the environmental variables before the job issubmitted. In this release, ASG-PRO/JCL Eclipse Plug-in supports Control-M and Zeke schedulers. For more informationon scheduler integration, see ASG-PRO/JCL Reference Information.

29

Setting the JCL Scan Options

https://docs.asg.com/op_pjm_3.5/pjmag/run_time_settings.htm

https://docs.asg.com/op_pjm_3.5/pjmug_jmp/jmp_main_page.htm

https://docs.asg.com/op_pjm_3.5/pjmrg/scheduler_interfaces_.htm

To set the JCL scan options:


l From the z/OS Navigator pane, select (Connect to z/OS) icon. In the Connect to z/OS dialog, clickManageProfiles.


2. In the PRO/JCL preference page, make sure that the correct System Name is selected or add a new one byclicking Add….

3. Make sure that the Connection Profile fields are filled in. See Connecting to z/OS and ASG-PRO/JCL for moreinformation.

4. Select the JCL Scan Options tab and fill the following details as per your requirement:

30



Includesummary in JCLscan output

Select to display the JCL scan options in the JCL scan report.

Reset PRO/JCLsimulatorbetween fileswhen validatingmultiple JCLs

Select if JCLs can be validated in any order. If not selected, the Dynamic Selection List dialog isdisplayed at the time of validating multiple JCLs to determine the order in which the JCLs shouldbe scanned.

31

Schedulers


Input Type

Select an input type from the list.

Input Type Description

JOB Process the input file as a job stream.

JCL

Process the input file either as JOBs or PROCs. PRO/JCL can distinguishbetween JOB-type and PROC-type input streams. Based on the inputstream, it automatically invokes the appropriate input type. This is thedefault input type.

IDCAMS Process the input file as IDCAMS control statements.

PROC Process the input file as PROCs.

IEBGENER Process the input file as IEBGENER control statements.

IEBCOPY Process the input file as IEBCOPY control statements.

IEHPROGM Process the input file as IEHPROGM control statements.

DB2 Process the input file as DB2 control statements.

DATA

This input type allows a JMP program to access and manipulate theinput records without PRO/JCL validating or reformatting them. Whenthis option is selected, make sure to enter the JMP member name andan output file.

ADRDSSU Process the input file as ADRDSSU control statements.

SORT Process the input file as SORT control statements.

RTS Member Enter the RTS member or leave blank to use the DEFAULT RTS member.

First PROCLIB Enter the library that are searched first before other libraries for PROC and INCLUDE members.

JCL Manipulation Program (JMP)

Member Name Enter the name of the JMP member to be executed.

Library Enter the name of the library containing the JMP program.

Parameters Enter the parameter to be passed to the JMP program.

If the member name is filled and if the library field is left blank, then the JMP program is assumed to be

32



in the SYSEXEC concatenation libraries used in the ASG-PRO/JCL started task.

Schedulers

SchedulerIntegration

Select to integrate a job scheduler and ASG-PRO/JCL.

Control-MSelect to integrate Control-M scheduler with ASG-PRO/JCL. The Run Date is enabled on selectingControl-M scheduler. It is the scheduled date for the job, date entered must be in MMDDYYformat and it is an optional field.

Zeke Select to integrate Zeke scheduler with ASG-PRO/JCL.


33

Schedulers

Setting the Remote Scan OptionsThis topic explains how to set scan options that are used when validating JCLs on remote machines. You can set thefollowing options in ASG-PRO/JCL Plug-in:

Run-Time Settings (RTS)RTS is a set of predefined run-time settings that control how PRO/JCL:

l Validates JCL and control statement members.

l Simulates MVS and non-IBM product functions (such as schedulers, security, and so on).

l Generates the Structured JCL Listing (SJL) report from the members it scans.

The run-time settings are defined in the RTS members which are stored in the Product Control File (PC File). The RTSmembers are created by the PRO/JCL system administrator. Users cannot create or edit the members but can select amember that is defined by the administrator. A default RTS member is available in the PC File named as DEFAULT. Thismember can be used by all users. For more information on RTS, see ASG-PRO/JCL's System Administration Document.

First PROCLIBWhen validating JCL, it might be necessary to specify a PROC library to be searched before any other libraries. TheRemote Scan Options tab provides a First PROCLIB field for this purpose. When this field is set, then PRO/JCL will look forthe PROC and INCLUDE members used in the current file in this library first before searching other libraries. The onlytype of library supported in this release is PDS.

JCL Manipulation Program (JMP)JMP is a set of defined rules that facilitate the automation of JCL change and site-specific standards enforcement tasks.These programs are custom-written REXX programs utilizing JMPAPI, RLAPI, and SYS functions. Sample JMP programsare available in the SYSEXEC library in the ASG-PRO/JCL started task. For a detailed introduction to PRO/JCL's JMPfacility, see ASG-PRO/JCL JMP User Information.

SchedulersA scheduler is a software tool that automates and controls a job execution when certain criteria are met. Generally, ascheduler is integrated with an application to handle the process of job execution. When jobs are executed using ascheduler, it allows the JCL to contain environmental variables, which must be resolved at the time of job submission.ASG-PRO/JCL supports a wide range of schedulers and it also resolves the environmental variables before the job issubmitted. In this release, ASG-PRO/JCL Eclipse Plug-in supports Control-M and Zeke schedulers. For more informationon scheduler integration, see ASG-PRO/JCL Reference Information.

To set the remote scan options:



34


https://docs.asg.com/op_pjm_3.5/pjmag/run_time_settings.htm

https://docs.asg.com/op_pjm_3.5/pjmug_jmp/jmp_main_page.htm

https://docs.asg.com/op_pjm_3.5/pjmrg/scheduler_interfaces_.htm




4. Select the Remote Scan Options tab and fill the following details as per your requirement:

35

Schedulers


Include summary in JCL scanoutput Select to display the JCL scan options in the JCL scan report.

RTS Member Enter the RTS member or leave blank to use the DEFAULT RTS member.

First PROCLIB Enter the library that are searched first before other libraries for PROC andINCLUDE members.

JCL Manipulation Program (JMP)

36



Member Name Enter the name of the JMP member to be executed.

Library Enter the name of the library containing the JMP program.

Parameters Enter the parameter to be passed to the JMP program.

If the member name is filled and if the library field is left blank, then the JMP program is assumed to bein the SYSEXEC concatenation libraries used in the ASG-PRO/JCL started task.

Schedulers

Scheduler Integration Select to integrate a job scheduler and ASG-PRO/JCL.

Control-MSelect to integrate Control-M scheduler with ASG-PRO/JCL. The Run Date isenabled on selecting Control-M scheduler. It is the scheduled date for the job,date entered must be in MMDDYY format and it is an optional field.

Zeke Select to integrate Zeke scheduler with ASG-PRO/JCL.


37

Schedulers

Setting the Reformat OptionsThis topic explains how to set reformat options that are used when reformatting a JCL. A well-aligned JCL helpsdevelopers to read, understand and make changes easily. PRO/JCL restructures the JCL into a standard, and easy-to-readformat based on the built-in defaults or based on the user defined reformatter settings. Reformatter Members containthe reformatter settings that define the appearance of each statement type. These members are maintained in thePRO/JCL Product Control File (PC File). The reformatter members are created by the PRO/JCL system administrator.Users cannot create or edit the members but can select a member that is defined by the administrator. A defaultreformatter member is available in the PC File named as DEFAULT. This member can be used by all users. For moreinformation on reformatter settings and reformatter member, see the topic: Reformatter Settings in PRO/JCL SystemAdministrator’s documentation.

PRO/JCL Eclipse Plug-in allows users to reformat a JCL:

l with or without validating a JCL

l using the default reformat member or a reformat member defined by the PRO/JCL system administrator

l save the reformatted results in the same input file or in a different output file

To set the reformat options:





38


https://docs.asg.com/op_pjm_3.5/pjmag/reformatter_settings.htm


4. Select the Reformat Options tab and fill the following details as per your requirement:

39

Setting the Reformat Options


Display reformat options before reformatting

Select to display the Reformat Options dialog each time thereformat operation is invoked and before the operation isexecuted. The dialog contains the reformat options that are setby the user in the Preferences(this) page. This will allow the userto review the reformat options and change them if required.

If not selected, the Reformat Options dialog will not be displayed,and the reformat process will continue with the options that areset in the Preference page.

40



Even when this option is not selected, the ReformatOptions dialog will be displayed if additionalinformation is required from the user at the time ofthe reformat operation.

Validate JCL before reformatting

Select to scan the input JCL first and continue with the reformatoperation only if no errors are found in the input JCL. If errors areidentified, then the reformat operation is not executed, and theerrors are displayed in the JCL Scan and Problems view.

If not selected, the reformatting is performed without scanningthe JCL for errors.

Reformat MemberEnter the reformat member name or select DEFAULT to use thedefault reformat settings.

Save reformatted JCL as different file

Select to save the results of the reformat operation in a differentfile other than the input file. On selecting this option, OutputLibrary, Prompt for new member name and Overwrite existingfile will be enabled.

Output Library

Enter the name of the dataset that will be used to save the resultsof reformat operation.

l Enter an existing dataset name only. This option willnot allocate a new dataset.

l This field is mandatory if user has selected Savereformatted JCL as different file option.

Prompt for new member name (original nameused if unchecked)

Select to enter a member name in the Reformat Options dialogwhich will be used to save the reformat operation results. TheReformat Options dialog is displayed each time the user invokesthe reformat command.

You can enter a member name only if the output fileis a PDS (Partitioned Data Set).

If not selected, the input file name will be used as the membername.

Overwriting existing file Select to overwrite the contents of the output file if it is an

41

Setting the Reformat Options


existing file.

If not selected and if the specified output file name already existsin z/OS, then the plug-in displays a dialog that requires userconfirmation either to overwrite existing member or to save thereformatted output in new member.

Open output file after reformattingSelect to automatically open and display the output file in JCLEditor view.

If not selected, the output file is not displayed.

5. Click Apply to save the scan options or click Apply and Close to save the reformat options and return to theConnect to z/OS dialog.

42


Working with z/OS DatasetsThis topic explains how to:

l display the z/OS datasets

l edit the z/OS datasets

l refresh the list of datasets

Displaying DatasetsDatasets that are in the z/OS system can be explored from the z/OS Navigator view.

To display datasets:

1. Select (Add High Level Qualifier) icon from the z/OS Navigator pane. The ADD HLQ dialog box appears.

If connection to z/OS is not established, then Connect to z/OS dialog appears and prompts formainframe credentials. See Connecting to z/OS and ASG-PRO/JCL for more information.

2. In the Dataset High Level Qualifier, enter/ select the dataset's high-level qualifier that you would like to viewand click Add.

43

Working with z/OS Datasets

l If you have entered the high-level qualifier for the first time, then on clicking Add, the HLQ is saved to theDataset High Level Qualifier list. The list keeps track of the HLQs that you have entered in the past so youdon’t have to retype again.

l To delete a saved HLQ from the Dataset High Level Qualifier list, select the HLQ and click Delete.

l If the entered HLQ is not found in z/OS, then the following error message is displayed. Make sure to enteran existing HLQ.

3. Datasets are displayed under a High-Level Qualifier (HLQ) in a tree-like structure. Expand the HLQ to view thefiles.

Icons in the tree structure represent the following:

44


Icon Description

node in a dataset qualifier

PDS or PDSE containing dataset members

sequential dataset

partitioned dataset that has been migrated

sequential dataset that has been migrated

member in PDS or PDSE

4. Double-click on a sequential dataset or a member of partitioned dataset to open the file in the JCL Editor. Thecontent of the file is displayed in the editor with the name of the file in its tab.

Editing and Saving DatasetsThe JCL Editor allows the user to edit and save a dataset.

To edit and save a dataset:

1. In the z/OS Navigator view, double-click on the file that you like to update. The file is displayed in the JCL Editor.

2. After updating the file, right-click in the JCL editor area to bring up the dataset contextual menu.

45

Editing and Saving Datasets

3. Select one of the options to save the changes to z/OS:

a. Save to z/OS - This option allows the user to save the file under the same dataset name.b. Save to z/OS As... - This option allows the user to save the file either as a new member in a PDS or as an

existing PS file. When this option is selected, user is prompted to enter a dataset name. Enter a name andclick OK.

This option will not allocate a new dataset.

4. Refresh the z/OS Navigator to view the changes.

46


Refreshing DatasetsThe z/OS Navigator view provides a refresh icon that refreshes the list of datasets.

You may need to refresh dataset list whenever you:

l save a file to z/OS

l add / delete / edit a dataset or a member in z/OS

To refresh datasets:

n Click the (Refresh View) icon from the z/OS Navigator pane.

See Validating JCL for information on scanning / validating a file.

47

Refreshing Datasets

Working with Local FilesASG-PRO/JCL Plug-in allows the user to scan files that are present in your local file system. This topic explains how towork with the files that are in your local file system. The files in your local system can be accessed from the ProjectExplorer view.

Displaying Local FilesTo display local files from the Project Explorer view, first they must be imported. You can import the files by one of theyfollowing method:

l dragging and dropping from the file system

l copying and pasting from the file system

l using the Import option

After importing the files, right-click on the file that you like to view and select Open With --> JCL Editor.

l If you don't find the JCL Editor option, select Other... and in the Editor Selection dialog, select JCL Editorfrom the Internal Editors list.

l When a file is opened from Project Explorer view, PRO/JCL commands are available in JCL Editor only. Thecommands are displayed as buttons in the toolbar as well as additional options in the Edit menu. If you arenot already connected to a PRO/JCL server when you run the PRO/JCL commands, you will be asked toconnect to PRO/JCL first before the commands are executed. Perform the steps in Connecting to z/OS andASG-PRO/JCL to connect to PRO/JCL's server.

To import files:

1. From the main menu, select File > Import.... The Import dialog appears.

48


2. Expand the General folder, select File System and click Next.

49

Displaying Local Files

3. In the next page of the Import dialog, click the Browse button. The Import from directory dialog appears.

50


4. Select the directory from which you would like to add the files and click Select Folder. The directory is displayedin the left pane of the Import dialog.

51


5. To select exactly the files you want to add, expand the hierarchies in the left pane and select or clear thecheckboxes that represent the folders in the selected directory. Then in the right pane, select or clearcheckboxes for individual files.

6. In the Into folder option, specify the project or folder that will be the import destination.

52


7. When you have finished specifying your import options, click Finish. The files are displayed in the ProjectExplorer view under the specified destination.

53


Editing and Saving Local FilesThe JCL editor allows you to edit and save a file that is in your local file system.

To edit a file:

1. In the Project Explorer view, right-click on the file that you want to edit and select Open With > Text Editor. Thefile is opened in the JCL editor area.

54


2. After updating the file, do one of the following:

l Press Ctrl+ S

l Select File > Save or Save As

l Right-click on the file and select Save.

l If the file opens in an external editor outside the Eclipse IDE, then you probably opened the file withoutselecting an editor.

l ASG recommends you to open the file in Text Editor.

l You may not see the PRO/JCL functions if you have opened the file in different editor other than Text Editor.

See Validating JCL for information on scanning / validating a file.

55

Editing and Saving Local Files

Validating JCLASG-PRO/JCL validates JCL in an input job stream, so that potential errors, including run-time, hidden, site-specific andsyntax errors can be corrected before the job stream is submitted for processing. Similarly, ASG-PRO/JCL Plug-inprocesses the entire job stream in the z/OS environment and displays the results in JCL Scan and Problems views.

You can validate a JCL file using the following options:

l Scan JCL

l Scan and submit JCL

l Scan JCL on Remote Machine

l Scan JCL before reformatting

l Scan Multiple JCL Members

l Scan Multiple JCL Members Using Selection List Directory

Scan JCLScan JCL option available in the ASG-PRO/JCL Plug-in is similar to ASG-PRO/JCL's JJ edit macro. The edit macro validatesthe JCL file during an ISPF Edit session and displays the Structured JCL Listing (SJL) report in browse mode. Similarly, theScan JCL option validates the JCL file that is active in the JCL Editor and displays the results in JCL Scan and Problemsviews.

l If you are not connected to a PRO/JCL server when you run the PRO/JCL commands, you will be asked toconnect to PRO/JCL first before the commands are executed. Perform the steps in Connecting to z/OS andASG-PRO/JCL to connect to PRO/JCL's server.

l When a file is opened from Project Explorer view, PRO/JCL commands are available in JCL Editor only.

l JCL scan options must be specified before you begin to scan a JCL file. For more information on JCL ScanOptions, see Setting the JCL Scan Options

To scan JCL:

1. Open the file that you want to scan in JCL editor.

2. Make changes, if any, and save it.

3. Select Scan JCL option from the Editmenu or icon from the toolbar.

56


../../../../../Content/Eclipse/Validating_JCL_Scan_JCL.htm

../../../../../Content/Eclipse/Validating JCL Using Scan and submit JCL.htm

../../../../../Content/Eclipse/Reformatting _JCL.htm

../../../../../Content/Eclipse/Scan_Multiple_JCL_Members.htm

../../../../../Content/Eclipse/Scan_Multiple_JCL_Members_Using_Selection_List_Directory.htm

4. PRO/JCL Plug-in validates the input JCL and displays the reports in the JCL Scan and Problems views. For moreinformation, refer to Reports.

When you scan another file in the JCL editor, the report in the JCL Scan view is replaced. However, themessages in the Problems view are not replaced, instead they add up to the existing messages.

57

Scan JCL

5. After validation, PRO/JCL Eclipse displays markers on the right and left margins of the JCL Editor. These markershelp you to quickly identify a problem in a file. See Markers for more information.

Scan and submit JCLScan and submit JCL option available in the ASG-PRO/JCL Plug-in is similar to the ASG-PRO/JCL's JJSUB edit macro. TheJJSUB edit macro validates a JCL and submits the job from the edit session. Similarly, the 'Scan and submit JCL' optionvalidates a file that is active in the JCL Editor and submits the job to z/OS. If the validation process completes with aseverity level of 4 or less, the job is automatically submitted and no reports are displayed in the JCL Scan or Problemsviews. If the severity level is greater than 4, then the job is not submitted and the reports are displayed.




To scan and submit JCL:

1. Open the file that you want to scan in JCL Editor.


3. Select Scan and submit JCL option from the Editmenu or icon from the toolbar.

58


4. PRO/JCL Eclipse validates the input JCL and displays the reports in the JCL Scan and Problems views dependingon the severity. The job will be submitted if the severity is less than or equal to 4.

Sample JCL file with severity level less or equal to 4The below sample JCL file with severity level less than or equal to 4 is automatically submitted to z/OS and a successmessage is displayed in the JCL Scan and PRO/JCL Console views.

59

Scan and submit JCL

Sample JCL file with severity level greater than 4The below sample JCL file with severity level greater than 4 is not submitted and a failure message along with severitylevel is displayed in the PRO/JCL Console view. Validation reports are displayed in JCL Scan and Problems views. Formore information on reports, refer to Reports.

60



Scan JCL on Remote MachineScan JCL on Remote Machine option available in the ASG-PRO/JCL Plug-in is similar to ASG-PRO/JCL's JJDIRECT editmacro. It allows you to scan the JCL on one system while logged onto another. This feature is used when the JCL on onesystem is ready for production or transfer to another, but you want to validate the JCL on the other system prior to itstransfer. Once the JCL passes through the validation, it can be transferred to another system. See Directed Execution formore information.


l When a file is opened from the Project Explorer view, PRO/JCL commands are available in JCL Editor only.

l Scan options must be specified before you begin to scan the JCLs. For information on remote scan options,see Setting the Remote Scan Options.

To scan JCL on remote machine:

1. Open the file that you want to scan in JCL Editor.


61

Scan JCL on Remote Machine

https://docs.asg.com/op_pjm_3.5/pjmug/directed_execution.htm

3. Select Scan JCL on Remote System option from the Editmenu or icon from the toolbar.

4. The Remote Machine Definitions dialog appears with the list of remote machine definitions. These definitionsare defined in ASG-PRO/JCL on the mainframe environment.

The Remote Scan Settings dialog has the following columns:

Column Description

Name Name of the remote definition.

Host Address orURL

TCP/IP address or host address of the remote machine where the validation will beperformed.

Port Port number of the remote machine where the PRO/JCL started task is running.

User Id User ID that will be used to logon to the remote machine.

By User User ID that is allowed to use this remote definition.

62


Column Description

By Machine Machine name or system ID on which the user is currently logged on.

Description Text describing the Remote Machine.

5. Select a machine definition and click Scan.

6. If the required details such as Port, User Id or Password are not saved for the selected remote definition, thenthe Remote Scan Settings dialog appears. Enter the required details and click OK.

Password in the Remote Scan Setting dialog is the password that will be used to logon to theremote machine along with the User Id.

7. PRO/JCL Plug-in validates the input JCL in the remote machine and displays the reports in the JCL Scan andProblems views. For more information, refer to Reports.


63

Scan JCL on Remote Machine

8. After validation, PRO/JCL Plug-in displays markers on the right and left margins of the JCL Editor. These markershelp you to quickly identify a problem in a file. See Markers for more information.

Scan Multiple JCL MembersThe Validate option in the ASG-PRO/JCL Plug-in allows you to scan multiple JCL members. You can scan all or selectedmembers of a dataset by using this option. When scanning multiple JCL members, you can specify whether each

64


member must be validated independent or dependent of other JCLs. If they are dependent on other JCLs, then you areallowed to specify the order in which the members must be validated.

l The Validate option is enabled only when a PDS is selected or when one or more members in the PDS areselected.


l Select the Reset PRO/JCL simulator between files when validating multiple JCLs option in the ASG-PRO/JCL Preference page if each JCL can be validated independent of other JCLs, i.e., JCLs can be run in anyorder. Do not select this option if JCLs are dependent on other JCLs, e.g., the output of one JCL is the inputfor another which requires JCLs to be validated in specific order. For more information, see Setting the JCLScan Options.

To scan multiple JCLs:

l Follow the steps in this section if each JCL can be validated independently.

l Make sure the option Reset PRO/JCL simulator between files when validating multiple JCLs is selected inASG-PRO/JCL Preference page under the JCL Scan Options tab.

1. Select the PDS to scan all the members in the PDS or to scan specific members of the PDS, open the PDS andselect the members that you like to scan using Ctrl + Click to select multiple members individually or Shift +Click to select a range of members.

2. Click on the icon or select Validate option from the z/OS Navigator view’s drop-down menu or right-clickon the dataset and select Validate option from the context menu.

65

Scan Multiple JCL Members

PRO/JCL Plug-in validates the selected JCLs and displays the reports in the JCL Scan and Problems views. Formore information, refer to Reports.

To scan multiple JCLs in user-defined order:

l Follow the steps in this section if the JCLs must be validated in user-defined order.

l Make sure the option Reset PRO/JCL simulator between files when validating multiple JCLs is not selectedin ASG-PRO/JCL Preference page under the JCL Scan Options tab.

1. Select the PDS that you like to validate.

66


2. Click on the icon or select Validate option from the z/OS Navigator view’s drop-down menu or right-clickon the dataset and select Validate option from the context menu. The Dynamic Selection List dialog appears.

3. Determine the order in which the members should be scanned in the Dynamic Selection List dialog using thefollowing fields.

67

Scan Multiple JCL Members


Input Library Displays the name of the selected dataset.

Members available Displays the list of all the members or selected members of the partitioned dataset.

Validation sequence Displays the selected members in the user-defined order. Initially, members aredisplayed in alphabetic order.

Add Click to move the selected members from theMembers available list to Validationsequence list.

Add All Click to move all the members from theMembers available list to Validationsequence list.

Remove Click to move the selected members from Validation sequence list back toMembersavailable list.

Remove All Click to move all the members from Validation sequence list back toMembersavailable list.

Top Click to move the selected member(s) in the Validation sequence list to the top ofthe list.

Up Click to move the selected member(s) in the Validation sequence list up by oneposition.

Down Click to move the selected member(s) in the Validation sequence list down by oneposition.

Bottom Click to move the selected member(s) in the Validation sequence list to the bottomof the list.

4. After selecting and arranging the members, click Validate. PRO/JCL Plug-in validates the input JCLs and displaysthe reports in the JCL Scan and Problems views. For more information, refer to Reports.

Scan Multiple JCL Members Using Selection List DirectoryA Selection List is a list of specific members that are selected from a partitioned dataset. The purpose of the selection listis to provide quick access to the commonly used members of the input library during the job validation. The SelectionList Directory displays all the selection lists that are available in the PRO/JCL server. This topic explains how to scanmultiple JCL members using the selection list directory, create a new selection list, and to update and delete an existingselection list.

l If you are not connected to a PRO/JCL server when you run the PRO/JCL commands, you will be asked toconnect to PRO/JCL first before the commands are executed. Perform the steps in Connecting to z/OS and

68


ASG-PRO/JCL to connect to PRO/JCL's server.


To scan multiple JCLs using selection list:

1. Select Selection List Directory option from the z/OS Navigator's view drop-down menu or click on the iconor right-click and select Selection List Directory option from the context menu. The Selection List Directorydialog appears with the Validate Selection List page.

The Validate Selection List page displays all the selection lists that are defined on the PRO/JCL server. The ValidateSelection List page has the following columns:

Column Description

Name Name of the selection list.

Library Name of the dataset containing the members.

Description Brief description of the selection list.

Owner User ID that created the selection list.

Last Updated Date on which the list was last updated.

2. Select the desired selection list and click Validate. PRO/JCL Plug-in validates the input JCLs and displays thereports in the JCL Scan and Problems views. For more information, refer to Reports.

69

Scan Multiple JCL Members Using Selection List Directory

To create a new selection list:

1. Right-click on a partitioned dataset or a selection of members and select New > Selection List or select Create

Selection List option from the z/OS Navigator view’s drop-down menu or click on the icon.

(OR)From the Selection List Directory dialog, click New….

The Selection List Details dialog appears with the Create Selection List page.

2. Fill in the following details in the Create Selection List page:

70



Selection List Name Enter a name for the new selection list.

Input Library

Displays the name of the selected dataset. If this field is blank, enter the name of thedataset from which you like to pull the member names and click Apply. If you haveentered a valid dataset name, then the members available in the dataset aredisplayed in theMembers available list.

Description Enter a brief description for the selection list.

Members available Displays the list of all the members or selected members of the partitioned dataset.

Validation sequence Displays the selected members in the user-defined order. Initially, members aredisplayed in alphabetic order.

Add Click to move the selected members from theMembers available list to Validationsequence list.

Add All Click to move all the members from theMembers available list to Validationsequence list.

Remove Click to move the selected members from Validation sequence list back toMembers

71



available list.

Remove All Click to move all the members from Validation sequence list back toMembersavailable list.

Top Click to move the selected member(s) in the Validation sequence list to the top ofthe list.

Up Click to move the selected member(s) in the Validation sequence list up by oneposition.

Down Click to move the selected member(s) in the Validation sequence list down by oneposition.

Bottom Click to move the selected member(s) in the Validation sequence list to the bottomof the list.

3. Click Save. The new selection list is saved to the PRO/JCL sever and it is listed in the Selection List Directory.

To update a selection list:

1. In the Selection List Directory, double-click on the selection list that you like to update or choose the selectionlist and click Edit....

72


2. In the Edit Selection List page, make the required changes and click Save to save the selection list in the samename.

If you like to save the selection list with a different name, then click Save As…. In the Add Selection List Name, enter aunique name in Selection List Name and click OK.

73


The selection list is updated with the latest changes in the PRO/JCL sever.

To delete a selection list:

1. In the Selection List Directory dialog, choose the selection list that you like to delete and click Remove. Aconfirmation message appears.

2. Click Yes, to delete the selection list.

The selection list details are deleted from the PRO/JCL sever and removed from the Selection List Directory.

74


Reformatting JCLReformat JCL option available in the ASG-PRO/JCL Plug-in allows the user to standardize the appearance of job-streamstatements. The standardized format helps the users to easily read, locate errors and update the JCLs. Perform the stepsin this topic to reformat a JCL.



l Reformat options must be specified before you begin to reformat a JCL file. For more information on JCLScan Options, see Setting the Reformat Options.

To reformat a JCL:

1. Open the file that you want to scan in JCL editor.


3. Select Reformat JCL option from the Edit menu or icon from the toolbar.

The Reformat Options dialog appears if option Display reformat options before reformatting or Prompt fornew member name (original name used if unchecked) is selected in the Preference page.

75

Reformatting JCL

4. The Reformat Options dialog displays the reformat options that are set in the Preference page. Review theoptions, if required update the options and click OK.

l If Output Library is a PDS, thenMember Name if PDS cannot be empty.

l If Overwrite existing file without prompting is not selected, and user enters an existing member name,then Save Reformat Output dialog is displayed. Click Yes to overwrite existing member or click No to savethe reformatted output in new member.

l If Save Output as different file is not selected in the Preference page, then Overwrite existing file withoutprompting and Open output file after reformatting options are disabled. These fields can be enabled if theuser enters a different dataset name in Output Library other than the input file name.

l The changes made in the Reformat Options dialog applies only to that specific instance of the reformatoperation. To set the options constantly, update the reformat options in the Preference page.

l If the user clicks Cancel or CLOSE, then the reformat operation is cancelled, and the message OperationCancelled by User is displayed in the JCL Scan view.

5. PRO/JCL Plug-in reformats the input JCL and displays the results.

l If Validate JCL before reformatting is not selected and PRO/JCL plug-in encounters any reformat errors,then the input file is not reformatted. The reformat errors are displayed in the JCL Scan and Problems view.

If Validate JCL before reformatting is selected, then the input file is scanned and continued with thereformat operation only if no errors are found in the input JCL. If errors are identified, then the reformatoperation is not executed, and the errors are displayed in the JCL Scan and Problems view.

76


l If Save reformatted JCL as different file is selected and Open output file after reformatting is not selected,then the output file containing the reformatted results will not be displayed automatically in the JCL Editorview. To view the results, user must open output file from the z/OS Navigator view.

JCL file before reformatting:

JCL file after reformatting:

77

Reformatting JCL

ReportsASG-PRO/JCL Plug-in validates the input JCL for any errors, warnings and infos (informational). The results of thevalidation are displayed in an easy-to-read report format. These reports are displayed automatically to the user in theJCL Scan and Problems views.

The reports contain the following messages:

Error

These messages are likely to affect processing and should be corrected before the JCL is submitted.

Warning

These messages may or may not affect processing and should be examined to determine if they must be correctedbefore the JCL is submitted.

Infos (Informational)

These messages are informational only and are unlikely to affect processing.

JCL Scan ReportIn the JCL Scan report, the messages appear immediately after the JCL line that contains errors or warnings or infos.

The messages are displayed in the following format:

[Message Number][Message Type] - [Message Text]

l Message number is a five digit numeral prefixed with DSS and suffixed with message type.

l Message type is a single letter appended with the message number and it indicates the following:o A – Advisoryo W –Warningo E – Error

l Message text is a brief description of the problem.

78


After the messages, the report summarizes the number of PROGRAM(S), PROC(S), INCLUDE(S) and DD statements thatare in the scanned JCL file.

At the end, the report displays the JCL scan options that are used in validating a JCL. This is displayed only when youselect the Include summary in JCL scan output option in the JCL Scan Options / Remote Scan Options tab in thePRO/JCL preference page.

When you scan multiple JCLs, the report of each JCL is displayed one after the other in the JCL Scan view. The reports ofJCLs appear in alphabetical order when the JCLs are validated independent of other JCLs. The reports appear in user-specified order when the JCLs are validated dependent of other JCLs. At the end of the reports, the JCL Scan Options thatwere used in validating the JCLs are displayed.

Problems ReportThe Problems report displays the list of messages that are identified after a JCL file is validated.

At the top, the report summarizes the number of errors, warnings, and infos encountered. Subsequent section displaysthe list of messages in each category.

79

Reports

Expand a category by clicking the icon to view the list.

Information about the messages are listed in a table format containing the following columns.

Column Description

Description Message describing the problem

Resource Member name in PDS or name of sequential dataset

Path Path of the Partitioned dataset name or sequential dataset

Location Indicates the JCL line number where the error appears

Type JCL Scan Message

PRO/JCL's JJFE edit macro locates a specific error in the Structured JCL Listing (SJL) output, similarly the Problems viewoffers a simple and quick way to locate the problem line that is associated with the message.

You can locate the problem either by:

l double-clicking on the message

Or

l right-click on the message to bring up the problems view's contextual menu and select the Go to option.

80


81

Reports

MarkersMarkers are small indicators that appear on the right and left margins of the JCL editor after a file is validated. Theseindicators enable you to quickly identify problems in your file. With these markers, user can navigate between theproblem lines and identify the highest severity in a file.

Markers are categorized as follows:

l Errors

l Warnings

l Infos (Information)

By default, only the error markers are displayed in the right and left margins. You can choose toshow / hide markers as per your preference. See Show or Hide Markers for more information.

Left-margin MarkersMarkers on the left-margin are placed next to the lines that are associated with some problems. These markers movewith the source lines when the content in the JCL editor is scrolled.

The left-margin can have different icons with the following meaning:

Icon Description

Errors

Warnings

Infos (Information)

When you hover the mouse cursor over a marker, a pop-up shows the description of the problem(s) associated with theline.

82


Right-margin MarkersMarkers on the right-margin show the relative locations of the tagged lines in the file. As a result, the markers are stillvisible when the margin shrinks to fit the screen. These markers do not move when the content in the editor is scrolled.Instead, clicking any marker in the right-margin would highlight the line associated with that marker. This allows you toquickly step through the problem lines in the editor by simply clicking the markers one by one.

Markers on the right-margin are color coded according to the message type:

Color Description

Blue Info messages

Yellow Warning messages

Red Error messages

When you hover the mouse cursor over a marker, a pop-up shows the description of the problem(s) associated with theline.

83

Right-margin Markers

The square that appears at the top right-margin shows the highest severity found in the file. Messages have thefollowing severity levels:

Severity Color Description

High Red Error messages

Medium Yellow Warning messages

Low Blue Info messages

The square is not displayed if there are no messages associated with the file.When you hover the mouse cursor over the square, a pop-up shows the total number of severities encountered in thecurrent file.

Show or Hide MarkersMarkers like errors, warnings and infos are used to quickly identify the problems in a file. You might find these markersuseful when you are validating a JCL file. You may choose how you want these markers to be displayed through thePreferences dialog

84


To show or hide markers:

1. From theWindow menu, select Preferences.

2. In the Preferences dialog, select General > Editors > Text Editors > Annotations.

85

Show or Hide Markers

3. In the Annotations page, under the Annotations types, select Errors / Infos /Warnings as per yourrequirement.

86


4. Under Show in, select or deselect the following options:

Options Description

Vertical ruler This option control the markers on the left-margin.

Overview ruler This option control the markers on the right-margin.

Text as

This option control the format of the tagged lines in the JCL editor region. You canselect on of the following formats:

l Box

l Dashed Box

l Highlighted

l Native Problem Underline

87

Show or Hide Markers

Options Description

l Squiggly Line

l Underlined

l Vertical Bar

5. After choosing your preference, click Apply to save the changes or click Apply and Close to save the changesand close the Annotations dialog.

88


Keyboard ShortcutsIn this topic you can find the list of all the keyboard shortcuts for different tasks performed in ASG-PRO/JCL Plug-in. Also,the topic explains the procedure to customize the default shortcuts.

The following table shows the shortcut keys used in ASG-PRO/JCL Plug-in:

Task Default Shortcut

Scan JCL Ctrl + 8

Scan and submit JCL Ctrl + 9

Scan JCL on Remote System Ctrl + 7

Reformat JCL Ctrl + 2

Save to z/OS Ctrl + 5

Save to z/OS As... Ctrl + Shift + 5

Customizing Keyboard ShortcutsThe key combinations for the existing shortcuts can be disabled or modified as required.

To customize shortcuts:

1. From theWindow menu, select Preferences.

2. In the Preferences dialog, select General > Keys.

89

Keyboard Shortcuts

3. In the Keys page, select the Command that you like to change. The values associated with the command ispopulated in the fields.

90


4. To change the key combinations, edit the Binding field.

5. If required, you can edit the values in the other fields.

6. click Apply to save the changes or click Apply and Close to save the changes and close the Preferences dialog.

91

Customizing Keyboard Shortcuts

UninstallationThis topic contains steps to uninstall ASG-PRO/JCL plug-in.

To uninstall ASG-PRO/JCL Plug-in:

1. Start Eclipse.



92


4. In the Installed Software tab, select ASG-PRO/JCL Development Environment and click Uninstall....

93

Uninstallation

5. Review the uninstall items and click Finish.

94


6. When the uninstallation is complete, you are prompted to restart the Eclipse application. Click Restart Now.

To verify if the plug-in has been uninstalled:

1. Start Eclipse



4. In the Installed Software tab, you should not see ASG-PRO/JCL Development Environment in the list ofinstalled software. This indicates that ASG-PRO/JCL Plug-in has been uninstalled.

95

Uninstallation

Documents

ASG-PRO/JCL Plug-in for Eclipse IDE