Follow the instructions in this topic if you want to use
the Import COBOL Files wizard to import COBOL files and their dependent
copy book files from a remote z/OS® system
into your service flow project.
Follow these steps to configure the Remote Systems view
in the Enterprise Service Tools perspective so
that you can import COBOL files and their dependent copy book files
from a remote z/OS system:
-
Modify the properties of the Partitioned Data Set (PDS) that
contains the COBOL source file:
Note: You must do this configuration
on the PDS itself (for example, USER25.SFP003.USER.SRCLIB)
inside the MVS Files folder. If you do this
configuration on the MVS Files folder, then
the configuration has no effect.
- In the Enterprise Service Tools perspective, in
the Remote Systems view, expand .
- Right-click the PDS that contains the COBOL source file.
- Select Properties. The Properties window
opens.
- If the COBOL source file in your PDS does not have the extension .cbl,
then follow these steps to add the extension:
- In the left pane of the Properties window, select Mapping.
- In the right pane:
- Select .
- In the input field, type cbl without a leading
period (cbl not .cbl).
- Modify the COBOL Settings property page:
- In the left pane, select COBOL Settings.
- In the right pane:
- Expand the procedure ELAXFCOC.
- Select the COBOL step.
- Click Edit Step. The COBOL Compile
Step Options window opens.
- In the COBOL Compile Step Options window:
- Clear the field Debug Data Set.
- Clear the field Object Deck Data Set.
- In the Copy Libraries field, type the name
of the PDS in which the copy book files are located.
Note: You
can enter multiple PDS names in this field. Type a space to separate
each name from a following name.
- Select the Support Error Feedback check
box if it is not already selected.
- The input field Data Set Qualifier for
Compiler Errors must contain a valid data set qualifier.
The default value is <userid.ERRCOB,
where <userid is your user ID.
Note: During the
Show
Dependencies operation (see step 5 below), when the Show
Dependencies processor creates an output data set to contain status
messages and error messages, the
Show Dependencies processor
uses this qualifier as a prefix to the name of the output data set.
- The output data set is written using your RACF® permissions.
- Before you attempt to import a COBOL file, verify that you have
write access to the area that you specify in this data set qualifier.
- Click OK.
- Modify the JCL Job Card and Data Set page:
- In the left pane of the Properties window, select JCL
Job Card and Data Set.
- In the right pane:
- In the JCL Job Card field, add a third
line that contains the JCLLIB CARD value for the server that you
are using.
- Click OK to close the Properties window.
Modify the properties of the Partitioned Data Set (PDS) that
contains the COBOL copy books:
- Right-click the PDS that contains the copy book files.
- Select Properties. The Properties window
opens.
- If the copy book files in your PDS do not have the extension .cpy,
then follow these steps to add the extension:
- In the left pane of the Properties window, select Mapping.
- In the right pane:
- Select .
- In the input field, type .cpy.
- Click OK to close the Properties window.
Start the
JES connection
if
it is not already connected:
- In the Remote Systems view, right-click the JES node.
- Select Connect.
Verify that the
Show Dependencies feature
is now working correctly for this COBOL source file:
- Right-click the COBOL source file.
- Click Show Dependencies.
- The Remote Systems view attempts to show the dependencies of the
COBOL source file by running the JCL statements that you modified
on the JCL Job Card and Data Set page of the
Properties window for the COBOL source code file (see step 3).
If the JCL statements are successful, then the Remote
Systems view displays the dependencies of copy book files on the COBOL
source file that you right-clicked.
Note: If an
error occurs when you try to import a COBOL file from a remote z/OS system:
- In the Remote Systems view:
- Find the most recently submitted job. This is the Show Dependencies
job.
- Open the Show Dependencies job and look for a JCL error, such
as an invalid data set name.
- Fix the problem that caused the JCL error.
- Try again to import the remote COBOL file.
If the Show Dependencies operation completed
successfully, then you should now be able to use the Import
COBOL Files wizard to import the COBOL source file and
its dependent copy book files from the remote z/OS system into your service flow project (see Starting the Import COBOL Files wizard).