HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DEFINE_RJE_WKSTN
Before the workstation can be used, you must create the workstation directory /var/opt/sna/rje/
WKST on the specified computer; WKST represents the name of the RJE workstation, as specified by the
workstation_name parameter above. You should also create a workstation style file with the name WKST.sty
in the directory /etc/opt/sna; for more information about the workstation style file, refer to the HP-UX
SNAplus2 RJE User’s Guide. All other files and directories required by the workstation will be created
automatically when the workstation is started.
In general, RJE users must run the spool commands (to submit, list, or cancel jobs) on the same computer
as the workstation. If you need to relax this restriction, you can do this by sharing the workstation directory
(and its subdirectories) using NFS; the spool commands can then be issued from any computer that has this
shared directory mounted.
If you want to allow the workstation to be run on more than one computer, set this parameter to all binary
zeros. In this case, you need to be aware of the following:
• Any computer where the workstation may be run must have the workstation directory and style file set
up as described above, and must include the workstation’s primary user and group in the HP-UX user
and group setup. You are recommended to set up the workstation directory on one computer and share it
using NFS, as described above.
• Jobs may be submitted to the workstation on any computer where the workstation may be run, but will
not be sent to the host until the workstation is started on the computer where the jobs are spooled.
• Output returned from the host will be sent to the appropriate file, directory, or program on the computer
where the workstation is running when it receives the output; this is not necessarily the same computer
from which the job was originally submitted.
def_data.num_lus
Number of LUs used by the workstation (1–5). This must match the number of LU names specified in the
following parameter.
def_data.lu_name
Names of the LUs that this workstation uses. Each name is an 8-byte type-A EBCDIC string, padded on the
right with EBCDIC spaces. It must match the name of a type 0–3 LU that has already been defined.
If the workstation uses more than one LU, all LUs must be defined at the same host (although they may be
associated with different local PUs and so access the host using different LSs).
3.41.3 Returned Parameters: Successful Execution
If the verb executes successfully, SNAplus2 returns the following parameters:
primary_rc
AP_OK
3.41.4 Returned Parameters: Parameter Check
If the verb does not execute because of a parameter error, SNAplus2 returns the following parameters:
primary_rc
AP_PARAMETER_CHECK
secondary_rc
AP_INVALID_LU_NAME
The lu_name parameter did not match the name of any defined type 0–3 LU or LU pool.
Appendix B, Common Return Codes lists further secondary return codes associated with
AP_PARAMETER_CHECK,
which are common to all NOF verbs.
250