NJE was designed to handle asynchronous file transfers. It copes well with queuing and retrying. It will alert operations when anything goes wrong, so your existing automation tools can intervene.
The NJE service running on the non-classic systems also has a sendfile command that lets you send files to an NJE-capable system. NJE interactions can be scripted simply because of its single command interface, store-and-forward mechanism, extensive logging support and use of return codes to indicate success or failure.
Files can be delivered to individual users, to devices, or to a program that can act on the contents of the file. Figure 1 shows a trivial file transfer from Linux to z/VM.
Submitting Jobs From Linux
Job streams can be created on the non-classic platform and submitted using the submit command.
An NJE job contains either SYSIN or SYSOUT data and the control records used to identify the data being transmitted. A node uses these control records to transmit an NJE job:
- A job header containing information that affects scheduling, security and accounting
- A data set header if the data is SYSOUT or optionally SYSIN data
- A job trailer containing information that affects output formatting and accounting.
All NJE jobs contain both a job header and job trailer.
Under VSE, the LDEST operand of the JOB JECL statement can be used to cause the output to be returned to the submitting node (see Figure 2). NJE wraps the JCL with the required control records. The job is transmitted to VSE, where POWER will schedule the job for execution. The job is executed and output is returned via the XMIT queue. The output from the job will be placed in the submitter’s “reader queue,” a temporary spool area used to hold NJE input and output files. You can interrogate the contents of your NJE spool queues using the:
- Qrdr command to query what files are available to you
- Peek command to preview files in your reader
- Receive command to transfer a file from the NJE spool area to your current working directory
- Purge command to discard an NJE spool file without receiving it.