of 595 /595
IBM VSE/Enterprise Systems Architecture VSE Central Functions VSE/REXX Reference Version 6 Release 7 SC33-6642-10

VSE/REXX Reference

  • Upload
    others

  • View
    14

  • Download
    0

Embed Size (px)

Citation preview

REXX/VSE Reference->
->
->
->
->
->
->
->
->
->
->
->
’)
->
->
and
tableo
defaults
to
the
null
string
and
is
padded
with
pad
or
truncated
as
necessary.
The
default
pad
is
a
blank.
Here
are
some
examples:
->
->
->
->
//
input.2
input.5
/*
/*
$$$$
*
$$
*
$$
$$$$
If
option
SECURE_WITH_CLIENT_AUTH
has
been
chosen
for
ACCEPT
or
TAKESOCKET,
information
from
the
’0’
’0
On
60’
The
C
socket
call
is:
getsockopt(s,
level,
optname,
optval,
optlen)
Messages
and
Return
Codes
For
a
list
of
REXX
Sockets
system
messages,
see
“REXX
Sockets
System
Messages”
on
page
309.
For
a
list
of
REXX
Sockets
return
codes,
see
“REXX
Sockets
Return
Codes”
on
page
309.
GiveSocket
Responses
If
successful,
this
function
returns
a
string
containing
return
code
0,
the
name
(subtask
ID)
of
the
initialized
socket
set,
the
maximum
number
of
preallocated
sockets
in
the
socket
set,
and
the
user
ID
of
the
TCP/IP
server
machine.
If
unsuccessful,
this
function
returns
a
string
containing
a
nonzero
return
code,
an
error
name,
and
an
error
message.
Examples
Call
Return
Values
’0
myId
40
TCPIP’
Messages
and
Return
Codes
For
a
list
of
REXX
Sockets
system
messages,
see
“REXX
Sockets
System
Messages”
on
page
309.
For
a
list
of
REXX
Sockets
return
codes,
see
“REXX
Sockets
Return
Codes”
on
page
309.
Ioctl
’0’
The
C
socket
call
is:
ioctl(s,
cmd,
data)
Messages
and
Return
Codes
For
a
list
of
REXX
Sockets
system
messages,
see
“REXX
Sockets
System
Messages”
on
page
309.
For
a
list
of
REXX
Sockets
return
codes,
see
“REXX
Sockets
Return
Codes”
on
page
309.
Listen
’0’
The
C
socket
call
is:
setsockopt(s,
level,
optname,
optval,
optlen)
Messages
and
Return
Codes
For
a
list
of
REXX
Sockets
system
messages,
see
“REXX
Sockets
System
Messages”
on
page
309.
For
a
list
of
REXX
Sockets
return
codes,
see
“REXX
Sockets
Return
Codes”
on
page
309.
ShutDown
See
Table
10
on
page
280.
Responses
If
successful,
this
function
returns
a
string
containing
return
code
0
and
a
new
socket
ID
(the
identifier
assigned
to
the
socket
on
the
taking
application).
If
unsuccessful,
this
function
returns
a
string
containing
a
nonzero
return
code,
an
error
name,
and
an
error
message.
Examples
Call
Return
Values
Return
Values:
’0
6
Hello
Return
Values:
’0
11
128.228.1.2’
Call:
Return
Values:
’0
23
AF_INET
123
128.228.1.2’
Messages
and
Return
Codes
For
a
list
of
REXX
Sockets
system
messages,
see
“REXX
Sockets
System
Messages”
on
page
309.
For
a
list
of
REXX
Sockets
return
codes,
see
“REXX
Sockets
Return
Codes”
on
page
309.
Version
parse
var
fc
socket_rc
parse
var
fc
socket_rc
newsocketid
if
socket_rc
parse
var
fc
accept_rc
rest
if
accept_rc
parse
var
fc
socket_rc
parse
var
fc
socket_rc
newsocketid
if
socket_rc
->
->
->
JUSTIFY(’<><.
.A.
JUSTIFY(’<><.
.A.
->
->
->
->
->
->
->
->
->
->
->
->
->

->
->
->
->
’’
->
->
->
’’
Dissatisfied
Overall
How
satisfied
are
you
that
the
information
in
this
book
is:
Very
Dissatisfied
Easy
to
Easy
to
Well
Applicable
to
your
Please
tell
us
how
we
can
improve
this
book:
Thank
you
for
your
responses.
May
we
contact
you?
h
Yes
h
No
When
you
send
comments
to
IBM,
you
grant
IBM
a
nonexclusive
right
to
use
or
distribute
your
comments
in
any
way
it
believes
appropriate
without
incurring
any
obligation
to
you.
Name
Address
Company
or
Organization
Phone
No.
Readers’
Comments
The Compiler and the Library for REXX/370
How to Use This Book
How to Read the Syntax Diagrams
For Further REXX Information
Structure and General Syntax
The VSE Host Command Environment
The POWER Host Command Environment
The JCL Host Command Environment
The LINK and LINKPGM Host Command Environments
The CONSOLE Host Command Environment
Chapter 3. Keyword Instructions
DROP
EXIT
IF
INTERPRET
ITERATE
LEAVE
NOP
NUMERIC
OPTIONS
PARSE
PROCEDURE
PULL
PUSH
QUEUE
RETURN
SAY
SELECT
SIGNAL
TRACE
BITXOR (Bit by Bit Exclusive OR)
B2X (Binary to Hexadecimal)
DELSTR (Delete String)
DELWORD (Delete Word)
EXTERNALS
FIND
INDEX
JUSTIFY
LINESIZE
USERID
PAUSEMSG
REXXIPT
REXXMSG
The Period as a Placeholder
Templates Containing String Patterns
Combining Patterns and Parsing Into Words
Parsing with Variable Patterns
Parsing with DBCS Characters
Introduction
Definition
Numbers
Precision
Addition and Subtraction
Power
Errors
Action Taken When a Condition Is Not Trapped
Action Taken When a Condition Is Trapped
Condition Information
Descriptive Strings
Special Variables
Chapter 9. Reserved Keywords, Special Variables, and Command Names
Reserved Keywords
Special Variables
Closing Files
Chapter 11. ADDRESS POWER Commands
Accessing Entries in VSE/POWER Queues
GETQE
CTL
VSE JCL ON Conditions
Chapter 13. Host Command Environments for Loading and Calling Programs
Host Commands
Return Codes from the LINK Environment
The LINKPGM Host Command Environment
Return Codes from the LINKPGM Environment
Table of Authorized Programs
Invoking ASSEMBLE and LNKEDT
Benefits of a Programmable REXX Console
A Look at VSE/ESA's Console Support
Console I/O Interfaces
DOM - Delete Operator Message
Master Console
User Console
Routing Codes
Service Offerings
Querying the Current Console Setting
Switching to a Console Session
Deactivating a Console Session
Examples of REXX and VSE Console Commands
Having Command Responses Outstanding in Parallel
Routing Messages From and Replies To a Specific Partition
Tracking of Operator Communication
Entry for ARXCONAD in Table SUBCOMTB
ARXCONAD Return Codes
Console-related REXX Functions
LOCKMGR
MERGE
OPERMSG
PAUSEMSG
SENDCMD
SENDMSG
SORTSTEM
Always Keep in Mind...
Do not Send Messages to "Yourself"
Redirect Some Output to SYSLST
Direct Messages to Only One Console (ECHOU Option)
Remember the REXNORC Profile
Finish All Preparatory Work Prior to ACTIVATE CONSOLE
Handle One Command at a Time
Start Testing on a Small Scale
The Most Important Rule...
Loading
Invocation
Termination
Event
Error Handling
Summary Listing of Demo Parts
REXXCPUM
Scenario
Invocation
REXXTRY
REXXJMGR
REXXWAIT
REXXASM
REXXSSDL
Retrieve Messages using Filter and Timestamp
Scan the Hardcopy File
Return and Reason Codes
CORCMD Command for Problem Solving
Chapter 15. REXX Sockets Application Program Interface
Programming Hints and Tips for Using REXX Sockets
SOCKET External Function
REXX Socket Functions
REXX-EXEC RSCLIENT Sample Program
REXX-EXEC RSSERVER Sample Program
Sample Programs Using the TCP/IP SSL Support with the REXX/VSE Socket Function
Server Program:
Client Program:
Chapter 16. Debug Aids
Interactive Debugging of Programs
Parameter Lists for REXX/VSE Routines
Specifying the Address of the Environment Block
Using the Environment Block Address Parameter
Using the Environment Block for Reentrant Environments
Return Codes for REXX/VSE Routines
Calling REXX
Return Codes
The ARXJCL Routine
The ARXEXEC Routine
Interface for Writing External Function and Subroutine Code
Function Packages
Variable Pool – ARXEXCOM
Trace and Execution Control Routine – ARXIC
Get Result Routine – ARXRLT
SAY Instruction Routine – ARXSAY
Halt Condition Routine – ARXHLT
Text Retrieval Routine – ARXTXT
LINESIZE Function Routine – ARXLIN
OUTTRAP Interface Routine – ARXOUT
Chapter 18. Customizing Services
Language Processor Environment Initialization and Termination
Loading and Freeing a REXX Program
Processing of the REXX Program
Overview of Replaceable Routines
Using the Environment Block
Characteristics of a Language Processor Environment
Flags and Corresponding Masks
How ARXINIT Determines What Values to Use for the Environment
Values ARXINIT Uses to Initialize Environments
Chains of Environments and How Environments Are Located
Locating a Language Processor Environment
Changing the Default Values for Initializing an Environment
Providing Your Own Parameters Module
Changing Values
Parameters You Cannot Change
Format of the Environment Block (ENVBLOCK)
Format of the Parameter Block (PARMBLOCK)
Format of the Work Block Extension
Format of the REXX Vector of External Entry Points
Changing the Maximum Number of Environments in a Partition
Using the Data Stack
Initialization Routine – ARXINIT
How ARXINIT Determines What Values to Use for the Environment
Parameters Module and In-Storage Parameter List
Specifying Values for the New Environment
Termination Routine – ARXTERM
Replaceable Routines
General Considerations
Installing Replaceable Routines
Exec Load Routine
The Exec Block
Buffer and Buffer Length Parameters
Line Number Parameter
I/O Control Block
Host Command Environment Routine
Storage Management Routine
User ID Routine
Message Identifier Routine
REXX Exit Routines
ARXINITX
ARXITMV
ARXTERMX
Installation-Supplied Exits
Chapter 22. Double-Byte Character Set (DBCS) Support
General Description
Symbols and Strings
Validation
Instruction Examples
Chapter 24. Support for the Library for REXX/370 in REXX/VSE
Benefits of Using a Compiler
Improved Performance
Improved Productivity and Quality
Portability of Compiled Programs
Routines and Interfaces for the Library for REXX/370 in REXX/VSE
Programming Routines for a REXX Compiler Runtime Processor
Routines and Interfaces to Support a REXX Compiler
Overview
The Compiler Programming Table
The Compiler Runtime Processor
Return Specifications
Return Codes
Programming Considerations
Entry Specifications
Return Specifications
Return Codes
Programming Considerations
Entry Specifications
Entry Specifications
Return Specifications
Return Codes
Appendix A. List of the Names of Macros Intended for Customers' Use
General-Use Programming Interfaces
Bibliography
Index