HP 3000 Manuals HP 3000 Manuals
#RJIN
The #RJIN command initiates the transmission of one input data set from
your HP 3000 computer system to the remote processor. The phrase "input
data set" as used in this manual means the equivalent of an input card
deck in an IBM 2780/3780 environment. This is usually an input file on
an HP 3000. The input data set can be read from an interactive terminal,
punched cards, punched tape, a disk file, or a magnetic tape file.
Syntax
#RJIN[input file reference]
[;COMPRESS={YES}
{NO}]
[;INCODE=code]
[;MAXSIZE=nnn]
[;NOETB ]
[;REC=start rec [,end rec]]
[;TRUNCATE={YES}
{NO}]
[;XEOF]
[;XPARENT={YES}
{NO}]
Parameters
You can specify the following parameters with the #RJIN command.
input file This is the name of the input file.
reference Input file reference may be any of the following:
logical device number
"device class name"
actual file designator
*formal file designator
@procedurename [{(G)}
{(P)}
{(S)}]
To designate the user-written procedure and the SL file
containing it, precede the actual name of the procedure,
procedurename, with an @, followed optionally by a letter in
parentheses indicating the SL file search order. When G is
specified, the segmented library files are searched in the
following order: logon group SL, SL.PUB in the logon account,
SL.PUB.SYS. When P is specified, the segmented library files are
searched in the following order: SL.PUB in the logon account,
SL.PUB.SYS. When S is specified or the parameter omitted, the
system segmented library file, SL.PUB.SYS is searched.
For information on user-written procedures, refer to appendix e,
"User-Written Procedures."
Default: If the input file reference parameter is omitted from
an #RJIN command, the one specified in the :RJE command is used.
COMPRESS= This parameter enables you to reduce a string of blank
characters to a two character sequence. This may enable you to
transmit more records per block. When data compression is being
performed, the input records are compressed by having
consecutive blanks transmitted as a two-byte sequence: an IGS
or GS control character followed by a count specifying the
number of blanks being compressed. If INCODE=BINARY or
XPARENT=YES is specified, no data compression will be performed;
the COMPRESS parameter is ignored.
Default: If the COMPRESS option is omitted, the default is NO
for IBM 2780 emulation and YES for IBM 3780 emulation.
YES Data compression is to be performed.
NO Data compression is not to be performed.
INCODE= INCODE permits you to specify the character code for a
particular input data set. In conjunction with the LINECODE
parameter of the #RJLINE command you may indicate specific
character conversion or no character conversion.
If the specified input code differs from the transmission code
as defined in the #RJLINE command, the necessary conversion is
done automatically by RJE.
Default: If the INCODE parameter is omitted, the default is
ASCII.
code Value:{ASCII}{EBCDIC}{BINARY}
The parameter INCODE=BINARY specifies that no conversion is to
be performed, which will cause the input data to be transmitted
bit for bit as it appears in the input data file. INCODE=
BINARY is ordinarily used when the input process is being
controlled by a user-supplied procedure. If INCODE=BINARY is
specified, no data compression will be performed; the COMPRESS
parameter is ignored.
The parameter INCODE=BINARY implies no short record truncation
regardless of what is specified by the TRUNCATE parameter. In
the transparent mode, if a record is shorter than 80 bytes, it
is expanded with blanks to make an 80-byte record. In the
nontransparent mode with the parameter INCODE=BINARY, the data
is not altered; it is neither truncated nor expanded.
MAXSIZE= For remote-to-remote communication only. MAXSIZE is used for
extending the 80-byte limit on the logical record size sent by
RJE. This may not be used when communicating with a host system,
but only between an HP 3000 emulating an IBM 2780 or an IBM 3780
and another system also emulating an IBM 2780 or an IBM 3780.
nnn Value: Number of words, when a positive number
from 001 to 128; number of bytes, when a
negative number from -001 to -256.
Default: If the MAXSIZE parameter is omitted, the default is an
80-byte limit on logical record size.
NOETB Used to implement JCA protocol. When NOETB is specified, no ETB
characters are generated by RJE. This requires that every block
of data end with an ETX character.
REC= This parameter specifies the MPE file system logical record
numbers that are the starting record and ending record numbers;
these are used for transmitting a part of an MPE file. The
first record in the file is record zero. REC may be used only
with disk files. Start rec must be supplied with this
parameter.
start rec Value: Positive integer; if used with end rec,
must be less than or equal to end rec.
end rec Value: Positive integer; if used with start
rec, must be greater than or equal to start
rec.
Defaults: Omission of the start rec causes the entire file to
be transmitted. If end rec is omitted, all records in the file
from start rec to end of file are transmitted.
TRUNCATE= This parameter enables you suppress blanks from the end of an
input record. Such records are ended by RJE with a control
character. This may enable you to transmit more records per
block. When short-record truncation is being performed,
trailing blanks are automatically suppressed from input records.
You need not include EM or IRS control characters in the data.
However, EM and IRS control characters, if present in the data,
will perform their intended function. RJE does not alter such
records.
TRUNCATE=YES will be ignored in the following two instances:
If INCODE=BINARY (implying no short record truncation and no
data compression) is specified.
If XPARENT=YES (implying no short record truncation) is
specified; in the transparent mode, if a record is shorter than
80 bytes, it is expanded with blanks to make an 80-byte record.
In the nontransparent mode with the parameter INCODE=BINARY, the
data is not altered. It is neither truncated nor expanded.
Default: If the TRUNCATE option is omitted, the default is YES.
YES Turns truncation on.
NO Turns truncation off.
XEOF XEOF prevents RJE from terminating after an input file read
error. This allows inputs from 'foreign' magnetic tapes and
other media, where the end-of-file conventions do not conform to
HP 3000 MPE standards.
Default: If XEOF is omitted, the default is RJE termination
after an input file read error.
XPARENT= Enables or disables the transparent mode, which is used for
sending binary data or for sending ASCII or EBCDIC data which
must include BSC control characters as part of the data.
Transparent and Nontransparent Modes: The Binary Synchronous
Communications (BSC) conventions require the use of certain
control characters. When ASCII or EBCDIC data is being
transmitted, data sent by a user ordinarily will not conflict
with the BSC control characters. However, when binary data is
being transmitted, certain bit sequences in the data could
duplicate some of the BSC control characters. This could cause
transmission errors. To avoid this, the transparent mode was
devised. In transparent mode, BSC control characters that are
to be interpreted as control characters are sent as part of a
two-byte DLE sequence: a DLE control character followed by the
particular BSC control character. In this case, the data sent
by a user may contain any bit pattern. If the data contains the
bit pattern for a DLE control character, RJE transmits two
successive DLE characters. The receiving station strips the DLE
control character pairs from the transmission block. The
non-data DLE is removed from the DLE-DLE pair and the remaining
DLE is accepted as data.
Default: If this parameter is omitted, data transmission is
nontransparent.
YES If XPARENT=YES is specified, the COMPRESS and
TRUNCATE parameters will be ignored. In the
transparent mode, if a record is shorter than
80 bytes, it is expanded with blanks to make an
80-byte record.
NO Transparent mode is disabled.
General Operation
The #RJIN command causes the transmission of one input data set from your
HP 3000 computer system to the remote processor. The input data set may
be read from an interactive terminal, a card reader, a punched tape
reader, a disk file, or a magnetic tape file. If it is being read from a
disk file, you can specify starting and/or ending logical record numbers
to transmit a part of that file.
A single #RJIN command immediately followed by an #RJOUT, #RJLIST,
#RJPUNCH, #RJEOD, or #RJEND command is the equivalent of reading one
input card deck through an IBM 2780 or IBM 3780 with the end-of-file key
on.
Two or more successive #RJIN commands are the equivalent of reading that
number of input card decks through an IBM 2780 or IBM 3780 with the
end-of-file key off. The first #RJLIST, #RJPUNCH, #RJEOD, or #RJEND
command following such a series of #RJIN commands implicitly performs the
same function as turning the end-of-file key on during the reading of the
final deck in the series.
In an interactive session, if #RJIN is reading its input data set from
$STDINX, a [CTRL]-Y may be used to terminate input mode and return to
command mode. However, buffered data and an EOT will not be sent, as
would be the case if an #RJEOD command were entered from $STDINX.
Examples
The following examples show different uses of the RJIN command and its
parameters.
Example 1
#RJIN 6
This command states that one input data set is to be read from logical
device 6 and transmitted to the remote processor. The following
parameters are assumed by default:
* Transmit the entire input data set.
* Perform data compression if an IBM 3780 is being emulated; do not
perform data compression if an IBM 2780 is being emulated.
* Use the nontransparent mode.
* Perform short-record truncation.
* The input records are in ASCII character code.
Example 2
#RJIN FILE6;REC=0,99; INCODE=EBCDIC
This command states that the first 100 logical records of a disk file
named FILE6 are to be transmitted to the remote processor and that the
input records are in EBCDIC character code. The following parameters are
assumed by default:
* Perform data compression if an IBM 3780 is being emulated; do not if
an IBM 2780 is being emulated.
* Use the nontransparent mode.
* Perform short-record truncation.
Example 3
#RJIN *INFILE;REC=26,50
This command states that logical records 26 through 50 of a disk file
equated to INFILE are to be transmitted to the remote processor. The
following parameters are assumed by default:
* Perform data compression if an IBM 3780 is being emulated; do not
perform data compression if an IBM 2780 is being emulated.
* Use the nontransparent mode.
* Perform short-record truncation.
* The input records are in ASCII character code.
Example 4
#RJIN @MYPROC(G);INCODE=BINARY
This command states that the procedure MYPROC is to be executed and that
no data conversion is to be performed. The logon group segmented
library, the PUB group segmented library of the logon account and the
system segmented library, SL.PUB.SYS, will be searched in that order for
the procedure MYPROC. The following parameters are assumed by default:
* Do not perform data compression.
* Use the nontransparent mode.
* Do not perform short-record truncation.
Example 5
#RJIN USLFILE;XPARENT=YES;MAXSIZE=128
This command states that an existing disk file name USLFILE is to be
transmitted in transparent mode. The transmitted record size will be the
record size read from the file or 128 words, whichever is smaller. The
following parameters are assumed by default:
* Transmit the entire data set.
* Do not perform data compression.
* Do not perform short-record truncation.
Example 6
#RJIN *IBMTAPE;XPARENT=YES;INCODE=BINARY;XEOF
Assuming IBMTAPE has been equated to a magnetic tape via an MPE :FILE
equation, this command states that no data conversion is to be performed,
data is to be transmitted in transparent mode and RJE is not to terminate
on an input file error. The following parameters are assumed by default:
* Do not perform data compression.
* Do not perform short-record truncation.
* Transmit the entire data set.
Example 7
#RJIN;XPARENT=YES;INCODE=BINARY
This command states that one input data set is to be read from the input
file specified in the :RJE command and be transmitted to the remote
processor in transparent mode. No data conversion will take place. The
above command would most likely appear in a :JOB deck and be immediately
followed by a binary data deck. The following parameters are assumed by
default:
* Transmit the entire input data set.
* Do not perform data compression.
* Do not perform short-record truncation.