HP-UX SNAplus2 RJE User’s Guide HP-UX 11i Edition 2 Manufacturing Part Number: J2743-90003 E0603 United States © Copyright 2003 © Hewlett-Packard Company, 2003. All rights reserved.
Legal Notices The information in this document is subject to change without notice. Hewlett-Packard makes no warranty of any kind with regard to this manual, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be held liable for errors contained herein or direct, indirect, special, incidental or consequential damages in connection with the furnishing, performance, or use of this material.
Trademark Notices ActivePerl is a registered trademark of ActiveState Tool Corporation Apple and Macintosh are trademarks of Apple Computer, Inc., registered in the United States and other countries. AppleShare is a registered trademark of Apple Computer, Inc. CHAMELEON is a trademark of NetManage, Inc. DIGITAL and PATHWORKS are trademarks of Digital Equipment Corporation. DiskAccess is a registered trademark of Intergraph. EXCURSION is a trademark of Digital Equipment Corporation.
SunForum is a registered trademark of Sun Microsystems, Inc. in the United States and other countries. UNIX is a registered trademark in the United States and other countries, licensed exclusively through The Open Group. VERITAS is a registered trademark of VERITAS Software Corporation. VERITAS File System is a trademark of VERITAS Software Corporation. WinDD is a trademark of Tektronix, Inc. X Window System is a trademark of the Massachusetts Institute of Technology.
Contents 1. Introducing SNAplus2 RJE Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 SNAplus2 RJE Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 Typical Uses of RJE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 2. Getting Started Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents Specifying New Temporary Directory Paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Setting logon_retry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Starting the Workstation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Displaying Workstation Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Stopping the Workstation. . . . . . . . .
Contents Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Overview of the Workstation Style File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . RJE Style File Customization Program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Starting the Program - Style File for a Configured Workstation . . . . . . . . . . . . . . . Starting the Program - Setting Up a Style File Offline . . .
Contents 8
Publishing History The manual publishing date and part number indicate its current edition. The publishing date will change when a new edition is published. Minor changes may be made without changing the publishing date. The manual part number will change when extensive changes are made. Manual updates may be issued between editions to correct errors or document product changes. To ensure that you receive the updated or new editions, you should subscribe to the appropriate product support service.
Preface The HP-UX SNAplus2 RJE User's Guide describes the features and functions of RJE (Remote Job Entry) for the HP computers. SNAplus2 RJE provides the functions of an IBM 3770 Communications terminal. It allows you to queue jobs locally before sending them to the host and to route host output to a disk file, a directory or a program. It also allows you to view host information and issue commands with the RJE console program.
Prerequisite Knowledge Before reading this book, you should have a knowledge of SNA and APPN concepts. For a list of books that provide this information, see “Related Publications”.
About This Book This section explains how information is organized and presented in this book. Organization of This Book This book is organized as follows: Chapter 1, “Introducing SNAplus2 RJE.” Introduces Remote Job Entry (RJE), with a description of features of the utility and some typical ways in which it is used. Chapter 2, “Getting Started.
Shows an example to show another way of using output programs to process data from the host with PDIRs. Typographic Conventions Table 1, shows the typographic styles used in this document. Table 1 14 Typographic Conventions Special Element Sample of Typography Document title HP-UX SNAplus2 Administration Guide File or path name /var/sna.
Table 1 Typographic Conventions (Continued) Special Element Sample of Typography Computer output +RSP Function, call, or entry point Set Session Parameters Motif button Status Motif menu Services Motif menu item Configure node parameters Keyboard keys Enter Hexadecimal value 0x0a 15
SNAplus2 Publications SNAplus2 publications include user guides, administrator guides, and programmer guides. The following sections describe the contents of each book. Publications for Users SNAplus2 provides the following user guides: HP-UX SNAplus2 General Information Provides an introduction to SNAplus2 and explains key product concepts and features.
Explains how to install the SNAplus2 software and set up system files. HP-UX SNAplus2 Upgrade Guide Provides information about upgrading to the current version of SNAplus2 from previous versions. It includes information about converting configuration files, rebuilding applications that use the SNAplus2 application program interfaces (APIs), and changes in other SNAplus2 functions. HP-UX SNAplus2 Administration Guide Explains how to enable, configure, and manage SNAplus2.
Contains the information you need to write application programs using Common Programming Interface for Communications (CPI-C). HP-UX SNAplus2 3270 & TN3270 HLLAPI Programmers Guide Contains the information you need to write application programs using High-Level Language Application Program Interface (HLLAPI). HP-UX SNAplus2 LUA Programmers Guide Contains the information you need to write applications using the Conventional LU Application Programming Interface (LUA).
Related Publications For information about SNA, APPN, or LU 6.2 architecture, refer to the following IBM documents: • IBM Systems Network Architecture: — LU 6.
1 Chapter 1 Introducing SNAplus2 RJE 21
Introducing SNAplus2 RJE Overview Overview SNAplus2 RJE (Remote Job Entry) provides the functions of an IBM 3770 terminal, allowing communications between SNAplus2 RJE and host Job Entry Subsystems such as the following: • MVS/JES2 (Multiple Virtual Storage/Job Entry Subsystem 2) • MVS/JES3 (Multiple Virtual Storage/Job Entry Subsystem 3) • VSE/POWER (Virtual Storage Extended/Job Entry Subsystem) Using SNAplus2 RJE, you can perform the following tasks: • Submit jobs to the host for processing • Re
Introducing SNAplus2 RJE SNAplus2 RJE Features SNAplus2 RJE Features SNAplus2 RJE provides the following features, which are explained in more detail in Chapter 3 of this manual: Multiple RJE Workstations SNAplus2 SNAplus2RJE allows the use of multiple RJE workstations on a single SNAplus2 system. Each workstation can be configured for use by a group of users. This allows you to provide different RJE configurations to suit the requirements of different groups of users.
Introducing SNAplus2 RJE SNAplus2 RJE Features SNAplus2 RJE accepts PDIRs (Peripheral Data Information Records ) from the host. These PDIRs can be stored in a file associated with the output or passed as parameters to a program that processes the output. Code Conversion Data can be translated from ASCII to EBCDIC when it is sent to the host, and from EBCDIC to ASCII when output is received from the host. It can also be sent or received as binary data without code conversion .
Introducing SNAplus2 RJE SNAplus2 RJE Features SNAplus2 RJE allows you to configure a device to send output to the rjeusrpad program which routes output according to a usr card specification and pads punch output that is received in TEXT mode. As an alternative to configuring an output program to do the padding, you can pad all punch output by setting the minor option punch_padding to the desired value.
Introducing SNAplus2 RJE Typical Uses of RJE Typical Uses of RJE Listed below are some typical ways that you can use the features of RJE: • Print host data at a local site You can use RJE to download host data sets (host files) from a remote host computer and print them on a local printer. • Transfer, store and retrieve files You can use RJE to transfer a file from the HP-UX computer to a host data set (host file) for storage.
2 Chapter 2 Getting Started 27
Getting Started Overview Overview This chapter illustrates a simple use of an SNAplus2 RJE workstation. It contains general instructions and information on starting the control daemon, starting and stopping the workstation, sending a job, checking workstation and job status, and cancelling a job.
Getting Started Using SNAplus2 RJE Using SNAplus2 RJE Before you begin, you must configure an RJE workstation and start the SNAplus2 daemon. The SNAplus2 configuration file, which is set up and maintained by the system administrator, contains information that is required for RJE communications. For configuration information, see the HP-UX SNAplus2 Administration Guide and Chapter 6, “SNAplus2 RJE Workstation Configuration,” of this manual.
Getting Started Using SNAplus2 RJE If you add this directory to the definition of the PATH environment variable in your .login or .profile file, the programs will be located automatically.
Getting Started Using SNAplus2 RJE Wkst Device Status LU Name Action -----------------------------------------------------------RJE1 CONS Inactive * * RJE1 PUN4 Inactive * * RJE1 PUN3 Inactive * * RJE1 PUN2 Inactive * * RJE1 PUN1 Inactive * * RJE1 RDR1 Inactive * * RJE1 PRT3 Inactive * * RJE1 PRT2 Inactive * * RJE1 PRT1 Inactive * * Wkst LU Name Status Device -----------------------------------------------------------RJE1 RJELU09 Idle * RJE1 RJELU08 Idle * RJE1 RJELU07 Idle * RJE1 RJELU06 Idle * It may tak
Getting Started Using SNAplus2 RJE FOLLOW indicates you are viewing new console messages. BROWSE appears when you are viewing earlier console messages. You can issue host commands by typing them on the command line and pressing Return. The following JES2 command displays information about the remote host that the workstation is using. (RMT26 is an example remote name. Use the remote name that is configured for your workstation): $DU,RMT26 To exit the console program, press f3 or CTRL-X.
Getting Started Using SNAplus2 RJE /opt/sna/bin/rjeusr or /opt/sna/bin/rjeusrpad, then output will be routed according to a usr card in the data, or it will be placed in the base directory for this workstation (/var/opt/sna/rje/RJE1/output). See Chapter 3, “SNAplus2 RJE Components and Operation,” of this manual for information on using the usr card. Stopping the Workstation To stop workstation RJE1, issue the following command: snaprjestop RJE1 The workstation will stop after one minute of inactivity.
Getting Started Using SNAplus2 RJE To delete all jobs that have been spooled with your user id, type the following: snaprjecan RJE1 ALL 34 Chapter 2
3 Chapter 3 SNAplus2 RJE Components and Operation 35
SNAplus2 RJE Components and Operation Overview Overview This chapter explains in detail how to submit and process a job with RJE, and explains the function of each of the components.
SNAplus2 RJE Components and Operation Overall Structure of SNAplus2 RJE Components Overall Structure of SNAplus2 RJE Components The following diagram illustrates the various RJE components and the interactions between them . The main components of RJE are the spool commands, the RJE workstation, and the output from the host.
SNAplus2 RJE Components and Operation Overall Structure of SNAplus2 RJE Components Output 38 The output from the host routes to a directory, program, or file (defined by the configuration).
SNAplus2 RJE Components and Operation Stages in Processing a Job Stages in Processing a Job To use RJE, all you need to do is start the RJE workstation and submit a job. The RJE workstation sends the job to the host and receives and routes the host output. Following are the stages involved in submitting and processing a job. These stages explain how RJE operates and shows all the facilities available to you. Step 1. Create the job file. Create a job file that contains the instructions required by the host.
SNAplus2 RJE Components and Operation Stages in Processing a Job must issue any other RJE commands related to the workstation (for example, commands for stopping the workstation, spool commands, or the console program), on the same computer. For more information on starting the workstation, see “Starting the RJE Workstation” in Chapter 2. Step 5. Send the job to the host. The RJE workstation takes jobs from the spool in the order in which you submit them and sends them to the host for processing.
SNAplus2 RJE Components and Operation Stages in Processing a Job Contents of a Job File The host operating system determines the syntax of the job file's contents. Check your host JES documentation for details.
SNAplus2 RJE Components and Operation Processing Input Data Processing Input Data After you submit the file for processing. This section explains how to send jobs to an RJE workstation and the options that are available for sending different types of job files. The commands below are spool control commands. Use these commands to access the job spool directly. A job spool exists for each RJE workstation. It is created the first time the workstation runs or the first time you send a job.
SNAplus2 RJE Components and Operation Processing Input Data When the RJE workstation runs, it accesses the job spool. If any jobs are in the queue, the workstation sends them to the host for processing in the order in which they are spooled. Once the workstation has successfully sent a job to the host, it removes this job from the spool. You can use the RJE console program to view messages from the host relating to the job and to issue host commands if necessary.
SNAplus2 RJE Components and Operation Processing Input Data This sends the file as exchange data with the default record length of 128 bytes. snaprjesend -e -m150 RJE1 myjob This command sends the file as exchange data with a maximum record length of 150 bytes. (See the description of the“snaprjesend” command in chapter 4 for more information.) Sending Text or Binary Files Most jobs sent with RJE will be text files in ASCII.
SNAplus2 RJE Components and Operation Processing Input Data • It separates text data into records at ASCII new-line characters, and sends each line of the text as a separate record. If a line is longer than the specified record length (see previous section), SNAplus2 RJE splits it into two (or more) records as necessary. For example, if a line 100 bytes long is sent using the default record length of 80 bytes, it will split the line into an 80-byte record and a 20-byte record.
SNAplus2 RJE Components and Operation Processing Output Data Processing Output Data This section explains how an RJE workstation handles the output returned to it by the host and the options that are available for processing and routing host output. The SNAplus2 RJE configuration determines some of the options for controlling output for a particular RJE workstation. This section explains those options and the use of the usr card.
SNAplus2 RJE Components and Operation Processing Output Data different host usage of each device type. SNAplus2 RJE punch devices can also handle output intended for exchange devices. See the section “Exchange Devices” later in this chapter for more information. SNAplus2 RJE printers and punches should be configured so that there is an equivalent SNAplus2 device for each host device. Host data sent to remote printer 1 (for example), is then routed to SNAplus2 printer 1 (designated PRT1).
SNAplus2 RJE Components and Operation Processing Output Data The following parameters for punches can be defined by using snaprjecust (the workstation customization program) or by editing the minor options in the style file (see Chapter 6, “SNAplus2 RJE Workstation Configuration.
SNAplus2 RJE Components and Operation Processing Output Data DATE The date of creation of the host data set (host file) being sent as output data. This is in the format MM/DD/YY (month, day, year). TIME The time of creation of the host data set (host file) being sent as output data. This is in the format HH.MM.SS (hours, minutes, seconds). FORMS The name (up to eight EBCDIC characters) of the printer forms to be used. Blank indicates “use the standard forms”.
SNAplus2 RJE Components and Operation Processing Output Data These five parameters make up the DSNAME parameter used by the host to identify the job. Many host systems use only JOBNAME and do not include the remaining parameters. REQID PDIR request identifier. This takes one of the following values: 0 - Standard PDIR 1 - Job separator PDIR 2 - System message PDIR The REQID parameter is not passed to output programs, but is available in the temporary PDIR file accessible by output programs.
SNAplus2 RJE Components and Operation Processing Output Data Directory The host sends output directed to this device to a new file in a directory specified in the configuration. The file is named RJE_abcdef, where abcdef represents a string of six alphabetic digits. The host creates file names in alphabetic order, but not necessarily in consecutive order. If you specify the pdir_passthrough option, PDIR information is written to a file that has the same name as the output file but with extension .i.
SNAplus2 RJE Components and Operation Processing Output Data output will be sent to the same file. The configuration specifies whether it will overwrite the existing contents of the file or be appended to it. If the data is replacing the contents of an existing file, and an error occurs while the data is being received, the file will be deleted unless the keep_failed_files minor option is set. If keep_failed_files is set, that data will be saved in a temporary file.
SNAplus2 RJE Components and Operation Processing Output Data punch files), or EXCnnnn (for exchange device files). For more information see “Usr Card Parameters” later in this chapter. The rjeusrpad program has an extra feature. It pads punch records with blanks. (See “Punch Padding”.) The above mentioned minor options (pdir_passthrough and keep_failed_files) can be defined by editing the RJE style file. Punch Padding The punch_padding option offers several variations on how punch output is padded.
SNAplus2 RJE Components and Operation Processing Output Data In order for the rjeusrpad program to work correctly, you must configure NL (new-line character) insertion for the device. The rjeusrpad program uses the new-line characters to determine where padding is necessary. It pads records to the maximum record length configured for the device on the host. New-line characters are stripped from the record after the padding is done.
SNAplus2 RJE Components and Operation Processing Output Data # copies=expr $6 + 1 cat | lp -f$3 -n $copies If this script, named myprog, is called with the PDIR parameters in the example PDIR file shown earlier in this chapter, the host output would be piped to: Figure 3-3 myjob 11/14/91 18.28.
SNAplus2 RJE Components and Operation Processing Output Data Syntax usr=(logon,place[,notify]) The usr card enables the user to determine where the returning file will be stored. For example, if you queue a file for transmission to the host, and you expect two files to be returned from the SNA host computer, each of those two returning files must contain a usr card if you want to choose the destinations for each of the two files.
SNAplus2 RJE Components and Operation Processing Output Data logon Your logon entry in /etc/passwd. The logon can be as many as 8 characters. place Place is a path to a directory or a file. The place field can contain as many as 60 characters. Path names in place are relative to your logon directory as specified in /etc/passwd if they do not begin with a slash. If place is a file, the file may or may not have execute permission.
SNAplus2 RJE Components and Operation Processing Output Data • $3 = filename (of the received file) • $4 = logon on usr card • $5 = directory given for logon in /etc/passwd These arguments append to the value in place in the sequence shown. In addition, if PDIR parameters are available to rjeusr or rjeusrpad (see “Sending PDIR Information” earlier in this chapter), these parameters will be appended to the arguments. The arguments are separated from place and from each other by a single space.
SNAplus2 RJE Components and Operation Processing Output Data The default notify value is 77. If you do not specify a notify value in the usr card, the default value of 77 will be used.
SNAplus2 RJE Components and Operation Processing Output Data • The usr card must be on a single line. • The usr card may not contain any tabs or blanks. • The characters “usr” in the usr card are not case sensitive and will be found if typed in all capital letters. If the entire usr card is in uppercase, upon receipt by RJE, rjeusr or rjeusrpad folds the entire card to lowercase. • The contents of the usr card are case sensitive.
SNAplus2 RJE Components and Operation Processing Output Data computer: a print file, and a punch file.
SNAplus2 RJE Components and Operation Processing Output Data Routing Received Files Without a usr Card If a printer or punch is configured to send output to rjeusr or rjeusrpad and no usr card is present, the file is placed in the output directory of the workstation's subdirectories (also referred to as the base directory). For example, for workstation RJE1, the output would be placed in the following directory: /var/opt/sna/rje/RJE1/output A unique system-generated name is assigned to each received file.
SNAplus2 RJE Components and Operation Processing Output Data Routing by usr Card If you include usr card(s) in your files, rjeusr or rjeusrpad writes to the file or directory you have specified in the place field. If rjeusr or rjeusrpad cannot write to place, it logs an error message and notifies you of the error by mail (see “Receiving Error Notification” in this chapter).
SNAplus2 RJE Components and Operation Running the RJE Workstation Running the RJE Workstation The RJE workstation is the program responsible for taking jobs from the spool and sending them to the host for processing. It also receives output returned by the host and routes it as required. Depending on your SNAplus2 RJE configuration , you may have more than one RJE workstation. You must configure each RJE workstation to run on a particular SNAplus2 computer (which may be either a server or a client).
SNAplus2 RJE Components and Operation Running the RJE Workstation Apart from the subdirectories output and .pgmout (temporary files for output to pr ograms), you cannot access these files and directories directly. They are for internal use by RJE programs. If the required files and directories do not already exist from a previous run of the workstation, SNAplus2 RJE creates them when you start the workstation or submit a job.
SNAplus2 RJE Components and Operation Running the RJE Workstation Specifying New Temporary Directory Paths Currently, if output is sent to a user program, all output is initially sent to a temporary file in /var/opt/sna/rje/WKST/.pgmout. Also, if the rjeusr or rjeusrpad programs are used and they leave output in the base directory, this output is placed in /var/opt/sna/rje/WKST/output.
SNAplus2 RJE Components and Operation Running the RJE Workstation Starting the Workstation Before starting an RJE workstation , be sure that the SNAplus2 daemon is running. See your system administrator if necessary, or refer to the HP-UX SNAplus2 Administration Guide. Also, be sure that your login ID is in the group configured for this workstation.
SNAplus2 RJE Components and Operation Running the RJE Workstation Use the snaprjestat command to display information about the workstation’s LUs, devices, or both, depending on the options you specify. For more information on this command, see the command description “snaprjestat” in Chapter 4 of this manual. To display status information on sent jobs, use the snaprjelst command to check the status (waiting, sending in progress, or failed) of jobs that have been spooled for a particular RJE workstation.
SNAplus2 RJE Components and Operation Running the RJE Workstation Default: The default is a one-minute inactivity time-out (-s1). If no option is specified, the workstation stops after one minute of no RJE activity. Because you may submit jobs at any time regardless of whether the workstation is running, you may add further jobs to the spool after you issue the stop command. The workstation continues to send these jobs, and does not stop until the spool is empty.
SNAplus2 RJE Components and Operation Getting Information About RJE Jobs Getting Information About RJE Jobs SNAplus2 logs detailed information about actions that occur on jobs and their data files that are received from the host. It sends information to the RJE job log file (if the job_logs option is defined) and to the RJE audit log file (if audit logging is enabled). Another way of getting RJE job information is by using the snaprjelst command.The following sections explain these three methods.
SNAplus2 RJE Components and Operation Getting Information About RJE Jobs RJE RJEF: Job spooled. Logon = bill Options = Userfile = demo2B Spool ID = SPL_rttnyq Cause: An RJE user has successfully added a job to the spool. This message shows details of the spooled job.
SNAplus2 RJE Components and Operation Getting Information About RJE Jobs ------------------ 11:29:23 PDT 09 Apr 1996 -----------------RJE Message 16389 - 63, Subcode: 55 - 1 Log category: AUDIT Cause Type: Audit System: hpntcbf Process ID: 3967 (snaprjestart) RJE RJEF: Received host output on PUN2 device Routed to program /opt/sna/bin//rjeusrpad Size of output = 111 bytes Filetype = PUNCH Mode = TEXT Cause: The workstation shown has successfully received data from the host.
SNAplus2 RJE Components and Operation Getting Information About RJE Jobs RJE: RJEF rjeusr/rjeusrpad has routed output for PUN2 usr logon = bill Filename = /home/bill/file1 Cause: rjeusr or rjeusrpad has successfully routed an output file to the indicated file name. Action: No action is required.
SNAplus2 RJE Components and Operation Getting Information About RJE Jobs Figure 3-4 Tue Apr 09 11:29:18 PDT 1996 RJEF QUED bill - * SPL_rttnyq demo2B Tue Apr 09 11:29:18 PDT 1996 RJEF SENT bill 0 * SPL_rttnyq demo2B Tue Apr 09 11:29:23 PDT 1996 RJEF CANL bill * * SPL_rttnyq demo2B Tue Apr 09 11:29:23 PDT 1996 RJEF RECV * PRT1 TEXT 5971 /home/bill//RJEFPRT1 Tue Apr 09 11:29:23 PDT 1996 RJEF RECV * PUN2 TEXT 111 /opt/sna/bin//rjeusrpad Tue Apr 09 11:29:23 PDT 1996 RJEF ROUT * PUN2 NO-USR * /var/opt/sna/rje/RJ
SNAplus2 RJE Components and Operation Getting Information About RJE Jobs The remaining fields in the entry depend on the event type. The fields shown for each event type are listed below. In some cases, the character “*” appears as a field in an entry. This indicates that a field stored internally by SNAplus2 is not used for that event type.
SNAplus2 RJE Components and Operation Getting Information About RJE Jobs RECV: Output Received from the Host The remaining fields are as follows: • “*” (unused field) • The name of the output device specified by the host: PRTn, PUNn, or EXCn (printer, punch or exchange device) • The data type specified by the host: TEXT (text data) or TRANSP (binary data) • The size of the output file (in kilobytes) • The directory and file name of the output file (or, for program output, the name of the output pro
SNAplus2 RJE Components and Operation Getting Information About RJE Jobs For more information on this command see the description “snaprjelst” in Chapter 4. Workstation Mail Messages For most messages that RJE prints to STDERR, there is a corresponding error message printed to either the audit log or error log. The following are mail messages that you may receive from the SNAplus2 RJE workstation: SNAplus2 RJE :9592 MESSAGE Message from SNAplus2 RJE workstation WKST. Notification ID #number.
SNAplus2 RJE Components and Operation Getting Information About RJE Jobs SNAplus2 RJE :9593 MESSAGE Message from SNAplus2 RJE workstation WKST. Error receiving to file or program name. Output file has been deleted. Incomplete data file may be written for next output to output device. Check error log file for SNAplus2 error messages. The workstation has reached the maximum number of times it will mail messages about this error. Restart the workstation if you wish to continue receiving this message.
4 Chapter 4 SNAplus2 RJE Commands 79
SNAplus2 RJE Commands Overview Overview This chapter explains each of the commands used to control SNAplus2 RJE . These commands allow you to start and stop the workstation, submit, list, or cancel jobs, check the workstation status and issue host commands .
SNAplus2 RJE Commands snaprjestart snaprjestart The snaprjestart command starts the RJE workstation which performs the following tasks: • Transfers jobs from the spool to the host for processing • Receives output from the host and routes it to the appropriate file or program. • Provides access to host console information Start the SNAplus2 RJE workstation on the computer for which it is configured. The SNAplus2 software must also be started on that computer.
SNAplus2 RJE Commands snaprjestart WKST is the name of the RJE workstation to start. This must be the name of an RJE workstation in the SNAplus2 configuration file, and your user ID must be in the group configured for this workstation. See your system administrator if necessary.
SNAplus2 RJE Commands snaprjestop snaprjestop The snaprjestop command stops the RJE workstation. You must use this command on the computer on which the workstation is running (the computer for which it is configured). See your system administrator if necessary, or refer to the HP-UX SNAplus2 Administration Guide for information on RJE workstation configuration. Syntax snaprjestop [-sn | -j | -i] WKST Options -sn The -sn option is the “inactivity” option.
SNAplus2 RJE Commands snaprjestop disrupt RJE processing. If a job was abandoned during sending, you will need to cancel and resubmit it in order to send it to the host when the workstation is restarted. (Some hosts may try to resend output that was abandoned during receiving.) Only one of these options may be specified. If none is specified, the default is -s1 (stop as soon as one minute has elapsed without RJE activity). When you use the -sn option, the workstation may take some time to stop.
SNAplus2 RJE Commands snaprjesend snaprjesend The snaprjesend command submits a job file to the RJE workstation for transfer to the host. It produces a spool file for the named workstation and returns the file ID for this spool file. Normally, the job file will be searched for the control lines and it will be converted from ASCII to EBCDIC . You can override these options if required.
SNAplus2 RJE Commands snaprjesend Lists control lines to standard error as the file is interpreted for transmission. -e Specifies the use of the RJE exchange device as the source of the file being sent. Data is sent as a basic exchange data set with a default record length of 128 bytes. -f Folds lower-case characters to upper-case characters. -h Lists the input lines to stdout without expanding tabs. The -h option cannot be used with the -l option. (Binary data will not be listed.
SNAplus2 RJE Commands snaprjesend Specifies the number of retry attempts for this job. If an error occurs during the sending of this job, the workstation will retry sending the job as many as n times. The maximum value for n is 99. n must be specified with this option. If -an is not specified, the number of retry attempts defaults to 10. -z Submits file for transmission without interpreting the file. Any other options specified in this command that require reading the file will be ignored.
SNAplus2 RJE Commands snaprjesend The name of the RJE workstation in the SNAplus2 configuration file that will process the job. This parameter must be specified whether or not the workstation is currently running. file The name of the file to be sent. If file is not specified, input is taken from STDIN. When a file is interpreted by snaprjesend, each control line must be no greater than 512 characters and any tabs in the line will be expanded to eight blanks.
SNAplus2 RJE Commands snaprjesend line begins with a tilde (˜). You can insert control lines into your file to open another input source within a job, or to set or clear command line options. A line in the source data that is recognized as a control line will cause snaprjesend to perform a function and the line will not be included in the queued data. The function of the control line is specified by use of the following arguments: • the period (.
SNAplus2 RJE Commands snaprjesend Note that if you are entering data from the terminal and the input is not being scanned for control lines (the -b option or the -i option is set), close the current source by entering [CTRL]-D once at the beginning of a line or three times if you are not at the beginning of a line. ˜-option(s) Set an option or options. The snaprjesend options that can be set include the following: If you specify more than one option, there must be no spaces between the options.
SNAplus2 RJE Commands snaprjesend Note that there must be a space between the ˜- and the option. The - must be specified with the option. If you specify the -b option or the -i option, interpretation of control lines is halted until an EOF for the new source is read. At that time, the options will no longer be in effect. This allows you to interpret control lines for some sources and not for others.
SNAplus2 RJE Commands snaprjesend Note the following: All input taken from the terminal in binary mode is entered as character data, and carriage returns are included in the file whenever you press Return. Example usage: To open terminal as source and specify the -b option and a prompt that says Enter data now, for example, you would enter: ˜+ -b:Enter data now ˜! [option]command Execute an HP-UX command. Execute the specified HP-UX command through the shell.
SNAplus2 RJE Commands snaprjesend If the shell command returns a non-zero status, the snaprjesend command will terminate, and the job will not be submitted. This error can be overridden with the -y option. ˜:message Print the contents of message on stdout. ˜˜comment Ignore this line. NOTE You must type in commands with the exact spacing shown in this list. Control Line Examples The following examples show how you might use control lines with the snaprjesend command.
SNAplus2 RJE Commands snaprjesend JCL commands that must be translated from ASCII to EBCDIC You can create the following master file called masterfile: ˜! cat JCLFILE Reads the file JCLFILE and sends the file in text mode. ˜! -b cat datafile Reads the file datafile, and turns on the -b option to suppress character translation and send the file in transparent mode. The -b option remains in effect until the EOF is encountered in datafile. ˜! cat MOREJCL Reads the file MOREJCL and sends that file in text mode.
SNAplus2 RJE Commands snaprjesend Use the ˜- [option]:prompt control line for opening STDIN as a new source. You can use this control line to redirect input from a file. Note that the prompt in this case is only a message to indicate that the file is being read since the file is being redirected to STDIN. Use the snaprjesend command: snaprjesend RJE1 masterfile < datafile where masterfile contains the lines: . . . //* JCL cards here ˜˜ Comment line.
SNAplus2 RJE Commands snaprjesend To view the input as the file is being scanned, use the ˜-options control line with either the -h or -l option. The -h option will not expand tabs to 8 blanks and the -l option will expand tabs to 8 blanks. For example: snaprjesend RJE1 masterjob where masterjob contains: . . . //* JCL cards here ˜˜ Note that since the control line for listing input is not ˜˜ at the top of the file, none of the JCL lines above will ˜˜ be listed to the screen.
SNAplus2 RJE Commands snaprjelst snaprjelst The snaprjelst command lists all the job files on the spool for an RJE workstation. The default of this command is to list only jobs that have been submitted either by you or by other users in your group and have not yet been sent to the host. However, by using the -s or -b option with the snaprjelst command, you can list jobs sent or both jobs waiting and sent.
SNAplus2 RJE Commands snaprjelst The -l option indicates “long listing”. By default, this command lists only the spool ID, login name, and job file name for each job. The -l option includes more detailed information. See the examples below for more information. -a The -a option indicates “all users”. By default, this command lists only the jobs that were submitted using your user ID. The -a option lists all jobs on the spool, submitted either by you or by other users of the workstation.
SNAplus2 RJE Commands snaprjelst The spool ID returned when the job was submitted. This is the ID required by the snaprjecan command to cancel the job. For a spooled job, this ID begins with the characters SPL. For a job that has been sent to the host (listed using the -s or -b option), this ID begins with the characters STS, and is the ID required by the snaprjepur command to purge the stored status information for this job. login name The login name of the user who submitted the job.
SNAplus2 RJE Commands snaprjelst The number of times the RJE workstation has tried to send the job. options Shows whether the following options were specified with the snaprjesend command: -z, -b, -e, -m. filesize The size of the job file in kilobytes. jobfilename The name of the job file submitted. Figure 4-1 Other messages may be sent to standard error Example of short listing SPL_fgdjlh jim jim/myjob.file Example of long listing SPL_fgdjlh jim 11/11/91 12:47:56 WAITING 10 0 - 5 jim/myjob.
SNAplus2 RJE Commands snaprjecan snaprjecan The snaprjecan command cancels a job on the spool. The user who submitted the job must be the same one who cancels it, using the same user ID. You must use this command on the computer for which the RJE workstation is configured, and the SNAplus2 software must be started on that computer. However, the RJE workstation need not be running.
SNAplus2 RJE Commands snaprjecan -r option, which is valid only if you are logged on as root, forces the job to be cancelled regardless of the user ID with which it was submitted. Parameters WKST WKST indicates the name of the RJE workstation to which the job was submitted. This must be the name of an RJE workstation in the SNAplus2 configuration file, whether or not the named workstation is currently running. spool-id spool-id indicates the spool ID of the job to be cancelled.
SNAplus2 RJE Commands snaprjepur snaprjepur The snaprjepur command purges status information for a job that has been sent to the host. The job must be purged by the user who submitted it (using the same user ID), except that a user logged on as root can purge any job. SNAplus2 stores information on sent jobs only if the list_sent_jobs option is set in the workstation style file (see Chapter 6, “SNAplus2 RJE Workstation Configuration,” of this manual for more information).
SNAplus2 RJE Commands snaprjepur WKST The name of the RJE workstation to which the job was submitted. This must be the name of an RJE Workstation in the SNAplus2 configuration file, whether or not the named workstation is currently running. The workstation name is not case sensitive. spool-id The spool ID of the job for which information is to be purged. You can purge information for more than one job by specifying more than one spool ID.
SNAplus2 RJE Commands snaprjestat snaprjestat The snaprjestat command is used to check the status of RJE workstation devices and LUs. Before you can view the status, you must have run the workstation at least once so that workstation directories are present. Additional information about jobs submitted and data files received can be obtained by looking at the audit log file. (See the section “Getting Information About RJE Jobs”, earlier in this manual).
SNAplus2 RJE Commands snaprjestat As an RJE user, you may check on the status of workstation devices and LUs. For example, you may wish to see if workstation LUs are active and connected to a host. The snaprjestat command displays the following information for workstation devices: WKST The name of the RJE workstation. device The name of the device owned by the workstation. This name can be a printer (PRTn), punch (PUNn), console (CONS), or reader (RDR1) device (n is a one digit decimal number.
SNAplus2 RJE Commands snaprjestat file. name is the name of the program, directory or file to which the output is being sent. JOB: spool-id For readers, the device is currently sending a job with the spool ID of spool-id. Outbound The console is currently receiving data from the host. Inbound The console is currently sending a command to the host. For each workstation LU, snaprjestat displays the following information: WKST The workstation name. LUname The name assigned to the LU when it was configured.
SNAplus2 RJE Commands snaprjestat Sending The LU is being used by a device to send a file or console command to the host. Suspended The LU is currently suspended by the host while receiving a file. Idle A session exists for the LU, but there is currently no activity. device The device that is currently using this LU. For disconnected, pending or idle LUs, device is indicated as *. The snaprjestat command will return the following exit codes: -1 An error has occurred with the command.
SNAplus2 RJE Commands snaprjestat printers, one punch device and three LUs assigned to it, and the printer and punch devices are designated by PRT and PUN plus the printer or punch number. Figure 4-2 WKST Device Status LU Name Action -------------------------------------------------------------RJE1 CONS Active FOURTH Outbound RJE1 PUN1 Suspended FOURTH Output to file /var/opt/sna/rje/RJE1 \ /output/punch.
SNAplus2 RJE Commands snaprjecmd snaprjecmd The snaprjecmd command sends host commands through the RJE console program (See Chapter 5, “SNAplus2 RJE Console Program.”) to a workstation from the command line. You must specify a workstation name with this command and optionally specify a host command string. If no host command string is specified, then input is taken from standard input. STDIN may be redirected to a file containing host commands.
SNAplus2 RJE Commands snaprjecmd preceded by \ to prevent their interpretation by the HP-UX shell. This is not necessary for commands entered from standard input. For the commands from standard input, each line should contain one host command. The output from the command may be an error message: RJE WORKSTATION WKST IS NOT RUNNING Or the output could be confirmation that commands are sent to the host: COMMAND SENT TO THE HOST: hostcommand Error messages for the command will be displayed in STDERR.
SNAplus2 RJE Commands snaprjeclr snaprjeclr The snaprjeclr command removes the files and directories associated with an RJE workstation. The files and directories will be rebuilt if a new job is submitted for the workstation, or if the workstation is restarted. The command must be issued by the system administrator.
SNAplus2 RJE Commands snaprjeclr WKST is the name of the RJE workstation for which you want to clear the directories. It is not case sensitive. Example snaprjeclr RJE1 If the command completes successfully, no messages are returned. A message is sent to standard error if SNAplus2 RJE detects an error.
SNAplus2 RJE Commands snaprjeclr 114 Chapter 4
5 Chapter 5 SNAplus2 RJE Console Program 115
SNAplus2 RJE Console Program Overview Overview This chapter explains how to use the SNAplus2 RJE console program to view messages produced by the host and to issue commands to the host .
SNAplus2 RJE Console Program RJE Console Program RJE Console Program The console program provides access to the host's Job Entry Subsystem console. You can use it to view messages produced by the host while processing jobs, to issue host commands , and to view the host's responses to console commands. You can either view this information as it becomes available, or browse through previous commands and messages.
SNAplus2 RJE Console Program Starting the Console Program Starting the Console Program You must start the console program on the computer for which the RJE workstation is configured, and the SNAplus2 software must be started on that computer. Your user ID must be in the group configured for this workstation. See your system administrator if necessary, or refer to the HP-UX SNAplus2 Administration Guide for information on RJE workstation configuration or for information on starting the SNAplus2 software.
SNAplus2 RJE Console Program Starting the Console Program Figure 5-1 SNAplus2 RJE Console Screen The bottom line of the screen is the status line. It includes the following: • reminders of the keystrokes for on-line help • whether command editing is in INSERT or REPLACE mode • the workstation name and its current status • whether the console display is in BROWSE or FOLLOW mode. The meaning of each of the status line messages is explained in later sections of this chapter.
SNAplus2 RJE Console Program Understanding Status Line Information Understanding Status Line Information The following indicators appear on the status line of the console program. HELP [f1] The f1 key displays help information on how to use the console program. INSERT Command editing is in insert mode. This means that any text you type into the command input area is inserted at the current cursor position. REPLACE Command editing is in replace mode.
SNAplus2 RJE Console Program Understanding Status Line Information workstation, or because the LUs are not active on the host. Check with your system administrator if necessary. WKST+ If the workstation name is followed by a + sign, this indicates that the workstation is active and that the connection to the host has been established. Host commands may be entered. FOLLOW The console program is in follow mode. This means that you are viewing new console messages as they are received.
SNAplus2 RJE Console Program Using the Console Program Using the Console Program The RJE console program allows you to do the following: • Enter host JES commands, and view the host's responses. • View earlier console information (commands that you have entered and output from the host). • Perform a temporary exit to the HP-UX command prompt, leaving the console program running. These options are discussed in the following sections.
SNAplus2 RJE Console Program Using the Console Program The console program retains the text of the ten previous commands. This means that you can repeat a previous command without having to type it in again. The keystrokes CTRL-P (previous command) and CTRL-O (next command) can be used to browse through the available commands. As you move forwards or backwards through them, each command in turn displays on the command input area.
SNAplus2 RJE Console Program Using the Console Program 20,000 bytes of information is received from the host, some of the data will be lost. When you move forward past the lost data, the message DATA LOST displays to indicate this. You can specify the maximum amount of console data that is saved by specifying the console_log_size option in the define_minor_options record in the RJE style file. The SNAplus2 RJE console uses two files that have stored console output from the host.
SNAplus2 RJE Console Program Using the Console Program You can then issue any other commands as required. For example, if you start the console program and find that the RJE workstation is not running, you can start the workstation from a temporary exit shell. You can also issue other HP-UX commands not related to SNAplus2 RJE To return to the console program from a temporary exit, use the HP-UX end-of-file (EOF) key sequence for your terminal (typically CTRL-D).
SNAplus2 RJE Console Program Using the Console Program 126 Chapter 5
6 Chapter 6 SNAplus2 RJE Workstation Configuration 127
SNAplus2 RJE Workstation Configuration Overview Overview This chapter gives configuration information for the RJE Workstation and how it communicates with the host and the output devices available to it. It also explains how to use the customization program and how to edit the minor options in the style file.
SNAplus2 RJE Workstation Configuration Overview of the Workstation Style File Overview of the Workstation Style File The workstation style file contains information on how the workstation interacts with the host Job Entry Subsystem, how it interacts with the local HP-UX computer to process input and output data, and the printer and punch devices available for processing output data. It may be maintained by the system administrator or by the users of the workstation.
SNAplus2 RJE Workstation Configuration RJE Style File Customization Program RJE Style File Customization Program The customization program provides a character-based menu interface that allows you to view, modify, and save the contents of a workstation style file. It provides defaults for the style file parameters wherever possible, and also performs cross-checking to ensure that the parameters you specify are valid.
SNAplus2 RJE Workstation Configuration RJE Style File Customization Program If a style file already exists for this workstation, the program opens the file and displays the current customization. Otherwise, it displays a message asking whether you want to create the file. Choose < OK >to create the file, or < Cancel > to exit the program without creating it. If you create a new file, all parameters are initially set to default values, which you can then customize as required.
SNAplus2 RJE Workstation Configuration RJE Style File Customization Program Printers Choose this option to customize printer devices that the workstation can use to process output returned from the host. Punches Choose this option to customize punch devices that the workstation can use to process output returned from the host. Figure 6-1 Customization Menu For help on each customization screen, press the F1 key.
SNAplus2 RJE Workstation Configuration RJE Style File Customization Program The program prompts you to confirm saving the changes. To save the changes choose < OK >, or < Cancel > if you do not want to save them. If you choose < Cancel >, any changes you have made are still displayed in the program (so that you can make further changes if necessary before saving the file), but are not written to the file.
SNAplus2 RJE Workstation Configuration RJE Style File Customization Program If you have made changes and have not saved them, the program prompts you to save the changes before exiting. You have the following options: • Choose < Yes > to save the changes and then exit the program. • Choose < No > to exit the program without saving the changes (so that the workstation's customization reverts to the last saved version). • Choose < Cancel > to abandon the exit.
SNAplus2 RJE Workstation Configuration RJE Style File Customization Program Information messages provide confirmation that an action has been accepted (such as saving the style file), or provide information related to the previous action that may be useful to you. No action is required. The title of a message box indicates whether it is an Error, Warning, or Information message. For all types of message boxes, choose the < Exit message > push button to acknowledge the message and continue with the program.
SNAplus2 RJE Workstation Configuration Text File Format Text File Format The RJE workstation style file is an ASCII text file, with information stored in readable text format. This allows you to check or modify the workstation definition using a standard text editor. The file consists of a series of records, each of which defines a set of options for the workstation or for the resources associated with it.
SNAplus2 RJE Workstation Configuration Text File Format The following paragraphs define how to specify a parameter of each type, and provide information on valid entries for each type. Character string A character string, for example RJE1. The individual parameter description gives details of the maximum and minimum length of each string.
SNAplus2 RJE Workstation Configuration Text File Format standard setup you do not need to specify every parameter in a record. (However, you may prefer to specify parameters explicitly, to make it easier to check the values that are being used.) The individual parameter descriptions later in this chapter include information on default values where applicable. If no default value is shown for a parameter, you must specify it explicitly.
SNAplus2 RJE Workstation Configuration RJE Style File Records RJE Style File Records The style file can contain the following records: define_workstation_ options Specifies how the workstation interacts with the host. define_minor_options Specifies how the workstation interacts with the HP-UX computer to process input and output data. define_forms_control Defines a Forms Control Butter, which specifies a page layout used by an RJE printer device.
SNAplus2 RJE Workstation Configuration RJE Style File Records logon_text The logon string required by the host Job Entry Subsystem. This string must be specified if the send-logon parameter below is set to YES. Check with your host Job Entry Subsystem personnel to determine the correct string to use. If send_logon is set to NO, this parameter must not be specified.
SNAplus2 RJE Workstation Configuration RJE Style File Records Check with your host Job Entry Subsystem personnel whether compression is supported. If compression is supported, you can choose whether to use it. Do not specify compression if the host configuration does not support it. Note that SNAplus2 RJE always accepts compressed files sent from the host. define_minor_options The define_minor_options record controls how the workstation interacts with the HP-UX computer to process input and output data.
SNAplus2 RJE Workstation Configuration RJE Style File Records for each workstation. This file is named job.log, and is stored in the main workstation directory /var/opt/sna/rje/WKST. For more details of the format of this file, see Chapter 3 of this manual. Allowed values: YES Log messages about job progress. NO Do not log messages. If you specify YES, SNAplus2 writes to this file each time a job is spooled, cancelled, or sent to the host, and each time output is received from the host.
SNAplus2 RJE Workstation Configuration RJE Style File Records information stored does not grow too large (which will affect disk occupancy and the performance of the RJE programs). See Chapter 4, “SNAplus2 RJE Commands,” of this manual for more information on RJE commands. Note also that SNAplus2 does not purge any existing stored information when you change this option from YES to NO. You should use the snaprjepur command to do this explicitly.
SNAplus2 RJE Workstation Configuration RJE Style File Records To specify that both text records and transparent data records are to be padded, specify the two constants combined using a + character: PAD_TEXT + PAD_TRANSP or PAD_TEXT + PAD_TRANSP_SPACE ff_passthrough Specifies whether the workstation should pass through Form (FF) characters received from the host in printer output, or convert them to line-feed characters. This option is ignored for punch output.
SNAplus2 RJE Workstation Configuration RJE Style File Records the same size, the first file is cleared, and the information is redirected to the first file. Using two files means that console logging can be active for an extended period of time, with a maximum disk space usage of twice the value specified here. The following parameters should all be left with their default settings. They are used only in special cases. For most installations, the default values are correct and should not be changed.
SNAplus2 RJE Workstation Configuration RJE Style File Records mail_on_events Specifies whether the workstation should send mail messages to the primary user of the workstation about the progress of jobs it is processing. Allowed values: YES Send mail messages about job progress. NO Do not send messages. keep_failed_files In general, the host’s configuration should specify a large checkpoint size, to ensure that it will always resend the complete output data and not try to restart part way through.
SNAplus2 RJE Workstation Configuration RJE Style File Records The RJE workstation normally runs in the background as a daemon process. To force it to run in the foreground, set run_in_foreground to YES. punch_nl_IRS When sending punch output, the host specifies the line length to be used for the output from each job. SNAplus2 normally inserts a new-line character each time an output line reaches this length.
SNAplus2 RJE Workstation Configuration RJE Style File Records This option is intended for use when you are having problems establishing sessions to the host. Displaying the complete SSCP data on the console allows you to check for error messages indicating why the session could not be established. In normal use, you should set this option to NO to avoid filling up the console log file with large amounts of data (particularly if the host sends a full-screen banner message at start of day).
SNAplus2 RJE Workstation Configuration RJE Style File Records form_name A name identifying this Forms Control Buffer. This name should not match any other form_name in the style file. If you include two Forms Control Buffers with the same name, only the second definition will be used. form_length The page length used to format the output data, specified by the number of lines the printer can print on each page. Specify a value in the range 1 - 255.
SNAplus2 RJE Workstation Configuration RJE Style File Records For each of the channels 2 to 12, specify a line number, between the values of the first_line and form_length parameters above. Alternatively, if you specify zero for a particular vertical channel position, the output device will simply interpret the “go to vertical channel n” instruction as a line feed. define_ws_device The define_ws_device record defines a printer or punch device used for processing RJE output.
SNAplus2 RJE Workstation Configuration RJE Style File Records device number 3. Problems may occur if the host attempts to route outputs from two different jobs to a punch and an exchange device that have the same number.
SNAplus2 RJE Workstation Configuration RJE Style File Records matches the host configuration. If there are gaps in the sequence of device numbers, the RJE programs will fail with an error message indicating that the style file is invalid. device_type Specifies the type of output device. Use this parameter to define the appropriate devices of each type to match the host configuration.
SNAplus2 RJE Workstation Configuration RJE Style File Records Specifies whether transparent data received from the host is translated from EBCDIC to ASCII before being routed to the appropriate file or program. The host output may contain control codes indicating that a section of data is to be treated as transparent data. This means that the printer should pass it through as received without checking it for control codes. Allowed values: YES Received transparent data is translated from EBCDIC to ASCII.
SNAplus2 RJE Workstation Configuration RJE Style File Records Output from each job is sent to a separate file in a particular directory. The directory must be specified using the output_path field (see below). The file will be given the name RJE_abcdef, where abcdef is an alphabetic string unique to each job. The strings are assigned in sequence so that alphabetical order corresponds to the order in which the outputs were received from the host. The output_file parameter must not be specified.
SNAplus2 RJE Workstation Configuration RJE Style File Records PDIR information is discarded. The usage of this field depends on the value of the output_type field, as follows: • If output_type is DIR or FILE, the information in any accompanying PDIRs is sent to a second file, with the same name as the output file but with the extension .i. For file output, this file is appended or overwritten in the same way as the output file.
SNAplus2 RJE Workstation Configuration RJE Style File Records • If output_type is DIR, the field specifies the directory in which output files are created. The primary user and group of the workstation must have read/write access to this directory. • If output_type is FILE, the field specifies the directory path of the file to which host output sent to this device is written. The primary user and group of the workstation must have read/write access to this directory.
SNAplus2 RJE Workstation Configuration Diagnostics Diagnostics SNAplus2 checks the contents of the workstation style file when you start the workstation, when you use the spool commands, or when you start the console program. If the contents of the style file are invalid, a message is written to standard error and the command fails. Full details of the style file error are written to the error log file. Check and correct the contents of the style file, and then retry the command.
SNAplus2 RJE Workstation Configuration Configuring RJE Workstation with xsnapadmin Configuring RJE Workstation with xsnapadmin In addition to using snaprjecust and the text style file to configure the workstation, you must define some parameters with xsnapadmin. This information is stored in the SNAplus2 configuration file, which is set up and maintained by the system administrator and contains information that is required for RJE communications.
A Appendix A Program Output with PDIRs 159
Program Output with PDIRs Overview Overview The following example is listed to show you another way of using output programs to process data from the host with PDIRs. It is being presented only as an example. It is not supported code.
Program Output with PDIRs Output Program Example Output Program Example This example consists of two parts: a script that is configured as the output program, and a C program that must be compiled and installed as /opt/sna/bin/catrje. The script uses this program to produce sections of the offset that are indexed by byte offsets from the PDIR file. The script is used to separate the header and trailer from an output file and then to append the header and trailer to each other section of output.
Program Output with PDIRs Output Program Example #This script requires that the output file contains at least #three PDIRs. There is a header, a trailer and at least one #other section of output. Otherwise, it will not work. #Change the name of the printer= statement to assign the #desired printing program. #The location of the temporary output file is the 14th #parameter passed to the program. From this name the script #can get the name of the PDIR file. output file=$14 pdir_file=$output_file.
Program Output with PDIRs Output Program Example #trailer = trailer PDIR #start header = first byte of header, start_trailer = first byte #of trailer ((trailer = end -1)) ((start_header = ${offset[1]} + 1)) ((start_trailer = ${offset[trailer]} + 1)) #cp the header and trailer to temporary files cat $output_file | catrje $start_header ${offset[2]} > \ $output_file.header cat $output-file | catrje $start_trailer ${offset[end]} > \ $output_file.
Program Output with PDIRs Output Program Example 164 Appendix A
Index Numerics 128-byte data records, 43 A access permissions, 65 accessing job spool, 42 add_punch_nl, 53 ASCII to EBCDIC conversion, 85 audit log file, 70 audit log file example, 70, 72 B binary data, 24 binary files, sending, 44, 45 BROWSE mode, 123 browse mode, limitations, 124 C cancelling jobs from spooler, 42, 101 CANL, 74, 75 checking RJE status, 105 code conversion, 24 command input area, console program, 119 commands snap start, 29 snapman, 29 snaprjecan, 33, 42, 101 snaprjeclr, 112 snaprjecmd, 11
Index define_workstation_options parameters description, 139 inbound_compression, 140 logon_text, 140 send_logon, 140 define_ws_device, 150 define_ws_device parameters add_punch_nl, 155 concatenate, 153 description, 151 device_number, 151 device_type, 152 form_name, 152 output_file, 156 output_path, 155 output_type, 153 pdir_passthrough, 154 translate_data, 152 translate_trans_data, 153 deleting job from spool, 33 diagnostics, 157 directory, output routed to, 51 documentation set, 16 E ending console progra
Index L list_sent_jobs, 33, 103 listing spooled jobs, 42 listing submitted jobs, 97 login ID requirements, 67 logon_retry, 66 logon_text, 138 long listing, example, 100 lost data, console, 124 ls (link station), starting, 29 M manual set, 16 messages status line, 31 modifiable data record size, 24 multiple LUs, 24 multiple RJE workstations, 23 MVS/JES2, 22 MVS/JES3, 22 N new-line characters (NL), 45, 53, 54 node, starting, 29 notification of errors, examples, 63 notification of received files, 58 notificati
Index R receiving files, precautions when routing by default, 62 when routing by usr card, 62 record lengths, 43 RECV, 74, 76 REPLACE mode, 122 REQID, 50 RJE audit log file, 70 RJE audit log file example, 70 RJE commands, 80 RJE console program, 43 RJE device name, 50 RJE job log file, 70, 73 RJE job log file example, 73 RJE job logging event CANL, 74, 75 QUED, 74 RECV, 74, 76 ROUT, 74, 76 SENT, 74, 75 RJE jobs getting information about, 70 RJE workstation, 37, 42 configuring, 45 exit, 32 running, 39 starti
Index options, 103 parameters, 103 syntax, 103 using, 103 snaprjesend command control lines, 88 example, 88 options, 85 parameters, 87, 88 syntax, 85 using, 32, 85 snaprjestart command options, 81 parameters, 82 syntax, 81 using, 30, 67, 81 snaprjestat command example, 108 options, 105 parameters, 105 syntax, 105 using, 30, 105 snaprjestop command example, 84 options, 68, 83 parameters, 84 syntax, 83 using, 33, 83 SPINNO, 49 spool commands cancel, 37 list, 37 send, 37 spool control commands, when to use, 64
Index W warning messages, 134 workstation configuration, 64 error messages, 77 error while sending, 64 RJE, 64 status of, 30 stopping, 67, 68, 83 when to run, 64 workstation style file for a configured workstation, 130 for an unconfigured workstation, 131 overview, 129 records, 136 starting snaprjecust, 130 text file, 136 X xsnapadmin, 158 170
