Skip to content
MainframeGo

REXX, COBOL, HLASM and Go, in examples you can run.

z/OS programs you can read in a few minutes, type into your own system and run, plus complete programs to study at your own pace. Each one comes with notes on what to look for.

REXX

The TSO/E scripting language. There is no compile step: you edit the member, save it and run it.

Where everything goes on the line
  • 1–80No column has a special meaning. The first line holds the comment /* REXX */, which tells an exec apart from a CLIST in SYSPROC.

Question and answer

The shortest exec that already does something useful: it asks a question, reads the keyboard and replies.

/* REXX - Asks for your name and replies */
say 'What is your name?'
parse pull name
if name = '' then name = 'visitor'
say 'Hello,' name'! Today is' date('N') 'and the time is' time()'.'
exit 0
  • parse pull keeps upper and lower case; pull on its own turns everything into upper case.
  • A blank between two terms becomes a blank in the output. Terms written side by side, like name'!', are joined with no blank.
  • date('N') returns the date in the default format, for example 22 Nov 2026.

A table with a stem

Stems are REXX compound variables. With a numeric index, they work like a table.

/* REXX - Adds up the cylinders used per volume */
vol.0 = 3
vol.1 = 'WORK01 1250'
vol.2 = 'WORK02  830'
vol.3 = 'PROD01 2975'
total = 0
do i = 1 to vol.0
  parse var vol.i volser cyls
  total = total + cyls
  say left(volser, 8) right(cyls, 6) 'cyl'
end
say left('Total', 8) right(total, 6) 'cyl'
exit 0
  • By convention, element .0 holds the number of items. That is how EXECIO and many functions return data.
  • parse var splits the text at the blanks and drops the extra spaces.
  • left and right line up the report columns.

Reading a dataset with EXECIO

In TSO/E, EXECIO loads a whole dataset into a stem with a single command.

/* REXX - Reads a sequential dataset and shows the first 5 lines */
address tso
"ALLOC FI(INDD) DA('YOURID.DATA.TEXT') SHR REUSE"
if rc <> 0 then do
  say 'ALLOC failed, RC='rc
  exit 8
end
"EXECIO * DISKR INDD (STEM line. FINIS"
"FREE FI(INDD)"
say 'Records read:' line.0
do i = 1 to min(line.0, 5)
  say right(i, 3)':' strip(line.i, 'T')
end
exit 0
  • Everything inside double quotes is sent to the environment chosen with address. The result comes back in the variable rc.
  • FINIS closes the dataset at the end of the read. Without it, the file stays open.
  • Replace YOURID.DATA.TEXT with one of your own datasets before running it.

COBOL

Fixed format comes from the punched card: the column where the text starts changes what the line means. The ruler at the top of each listing helps you check.

Where everything goes on the line
  • 1–6Sequence number, optional.
  • 7Indicator: * turns the line into a comment, - continues a literal.
  • 8–11Area A: divisions, sections, paragraphs, FDs and levels 01 and 77.
  • 12–72Area B: statements and the other data levels.
  • 73–80Identification, ignored by the compiler.

Simple interest with COMP-3

Packed fields are the usual format for money amounts in mainframe files.


       IDENTIFICATION DIVISION.
       PROGRAM-ID. INTRST01.
      * Computes simple interest using packed fields (COMP-3).
       DATA DIVISION.
       WORKING-STORAGE SECTION.
       01  WS-PRINCIPAL      PIC S9(7)V99 COMP-3 VALUE 1500.00.
       01  WS-RATE           PIC S9(3)V99 COMP-3 VALUE 2.50.
       01  WS-MONTHS         PIC S9(3)    COMP-3 VALUE 12.
       01  WS-INTEREST       PIC S9(7)V99 COMP-3.
       01  WS-INTEREST-ED    PIC Z,ZZZ,ZZ9.99.
       PROCEDURE DIVISION.
           COMPUTE WS-INTEREST ROUNDED =
                   WS-PRINCIPAL * WS-RATE * WS-MONTHS / 100
           MOVE WS-INTEREST TO WS-INTEREST-ED
           DISPLAY 'INTEREST: ' WS-INTEREST-ED
           GOBACK.
  • COMP-3 stores two digits per byte and the sign in the last half byte. S9(7)V99 has 9 digits and takes 5 bytes.
  • The V marks the decimal point without taking up space in the field.
  • The edited field Z,ZZZ,ZZ9.99 replaces leading zeros with blanks. The output is INTEREST: 450.00.

Reading a sequential file

The full life cycle of a file: open, read to the end, count and close, always checking the FILE STATUS.


       IDENTIFICATION DIVISION.
       PROGRAM-ID. READSEQ1.
       ENVIRONMENT DIVISION.
       INPUT-OUTPUT SECTION.
       FILE-CONTROL.
           SELECT CUSTOMER ASSIGN TO CUSTOMER
               ORGANIZATION IS SEQUENTIAL
               FILE STATUS IS WS-FS.
       DATA DIVISION.
       FILE SECTION.
       FD  CUSTOMER
           RECORDING MODE IS F.
       01  CUST-REC.
           05  CUST-ID       PIC 9(6).
           05  CUST-NAME     PIC X(30).
           05  CUST-BALANCE  PIC S9(7)V99 COMP-3.
           05  FILLER        PIC X(39).
       WORKING-STORAGE SECTION.
       01  WS-FS             PIC XX.
           88  FS-OK                  VALUE '00'.
       01  WS-RECS-READ      PIC 9(7) VALUE ZERO.
       PROCEDURE DIVISION.
           OPEN INPUT CUSTOMER
           IF NOT FS-OK
               DISPLAY 'OPEN FAILED, FILE STATUS ' WS-FS
               MOVE 12 TO RETURN-CODE
               GOBACK
           END-IF
           PERFORM UNTIL NOT FS-OK
               READ CUSTOMER
                   AT END
                       CONTINUE
                   NOT AT END
                       ADD 1 TO WS-RECS-READ
                       DISPLAY CUST-ID ' ' CUST-NAME
               END-READ
           END-PERFORM
           CLOSE CUSTOMER
           DISPLAY 'RECORDS READ: ' WS-RECS-READ
           GOBACK.
  • The name in ASSIGN TO is the JCL DD name: the job needs a //CUSTOMER DD pointing to the dataset.
  • FILE STATUS 00 means a normal read and 10 means end of file. The loop ends on any value other than 00.
  • The fields add up to 80 bytes (6 + 30 + 5 + 39), the fixed record length.

A table with OCCURS and EVALUATE

A small table loaded with REDEFINES and classified with EVALUATE, the replacement for nested IFs.


       IDENTIFICATION DIVISION.
       PROGRAM-ID. GRADES01.
       DATA DIVISION.
       WORKING-STORAGE SECTION.
       01  WS-VALUES.
           05  FILLER        PIC 9(3) VALUE 095.
           05  FILLER        PIC 9(3) VALUE 072.
           05  FILLER        PIC 9(3) VALUE 048.
       01  WS-TABLE REDEFINES WS-VALUES.
           05  WS-SCORE      PIC 9(3) OCCURS 3 TIMES.
       01  WS-I              PIC 9(2).
       PROCEDURE DIVISION.
           PERFORM VARYING WS-I FROM 1 BY 1 UNTIL WS-I > 3
               EVALUATE TRUE
                   WHEN WS-SCORE (WS-I) >= 90
                       DISPLAY WS-SCORE (WS-I) ' EXCELLENT'
                   WHEN WS-SCORE (WS-I) >= 60
                       DISPLAY WS-SCORE (WS-I) ' PASSED'
                   WHEN OTHER
                       DISPLAY WS-SCORE (WS-I) ' FAILED'
               END-EVALUATE
           END-PERFORM
           GOBACK.
  • REDEFINES gives a second view of the same storage: the three FILLERs become the three elements of the table.
  • EVALUATE TRUE runs only the first WHEN that is true, from top to bottom.
  • In COBOL, table subscripts start at 1.

HLASM

The z/OS High Level Assembler. Each line is a machine instruction, an assembler directive or a macro, with its fields in conventional columns.

Where everything goes on the line
  • 1–8Name (label). It must start in column 1; a * in column 1 makes the line a comment.
  • 10–14Operation: instruction, directive or macro. Column 10 is a convention.
  • 16–71Operands, with no blanks between them. Anything after the first blank is a remark.
  • 72Continuation: any character here continues the statement in column 16 of the next line.
  • 73–80Sequence number, optional.

Program skeleton with WTO

The structure every program repeats: save the registers, set up the base, do the work and hand control back.


HELLO01  CSECT
HELLO01  AMODE 31
HELLO01  RMODE ANY
         STM   R14,R12,12(R13)     Save the caller's registers
         LR    R12,R15             R12 = entry address (base)
         USING HELLO01,R12
         LA    R2,SAVEAREA
         ST    R13,4(,R2)          Chain: our area -> caller
         ST    R2,8(,R13)          Chain: caller -> our area
         LR    R13,R2              R13 = our save area
*
         WTO   'HELLO, Z/OS - FIRST HLASM PROGRAM'
*
         L     R13,4(,R13)         Back to the caller's save area
         LM    R14,R12,12(R13)     Restore the registers
         XR    R15,R15             Return code = 0
         BR    R14                 Return to the caller
*
SAVEAREA DC    18F'0'
         YREGS
         END   HELLO01
  • On entry, R15 holds the program address, R14 the return address and R13 the caller's save area.
  • The save area is 18 fullwords. The chaining at offsets 4 and 8 lets the system walk the call chain in a dump.
  • The YREGS macro generates the names R0 to R15. WTO writes the message to the console and the job log.

Adding up a table with BCT

Binary arithmetic in registers, walking a table of fullwords with a counter.


SUM01    CSECT
SUM01    AMODE 31
SUM01    RMODE ANY
         STM   R14,R12,12(R13)     Save the caller's registers
         LR    R12,R15
         USING SUM01,R12
*
         XR    R3,R3               R3 = accumulator, starts at zero
         LA    R4,TABLE            R4 = address of the current item
         LA    R5,COUNT            R5 = number of items
LOOP     A     R3,0(,R4)           Add the fullword R4 points to
         LA    R4,4(,R4)           Advance 4 bytes, next item
         BCT   R5,LOOP             R5 = R5 - 1; loop if R5 <> 0
*
         LR    R15,R3              Return the sum as return code
         L     R14,12(,R13)        Restore R14
         LM    R0,R12,20(R13)      Restore R0 to R12, keep R15
         BR    R14
*
TABLE    DC    F'10,20,30,40,50'
COUNT    EQU   (*-TABLE)/4
         YREGS
         END   SUM01
  • BCT subtracts 1 from the register and branches while the result is not zero: a loop in a single instruction.
  • COUNT is computed by the assembler. If you add items to the table, the counter adjusts itself.
  • The job ends with RC=0150, the sum of the five values. This program calls nobody, so it does not need a save area of its own.

Binary to text with CVD and ED

A number in a register is not readable. The way to text goes through packed decimal.


EDIT01   CSECT
EDIT01   AMODE 31
EDIT01   RMODE ANY
         STM   R14,R12,12(R13)     Save the caller's registers
         LR    R12,R15
         USING EDIT01,R12
         LA    R2,SAVEAREA
         ST    R13,4(,R2)
         ST    R2,8(,R13)
         LR    R13,R2
*
         L     R3,VALUE            R3 = 1234567 in binary
         CVD   R3,DWORD            Binary -> packed decimal
         MVC   EDITED,MASK         Copy the edit mask
         ED    EDITED,DWORD+4      Packed -> text, no leading zeros
         WTO   TEXT=MSG            Variable-length message
*
         L     R13,4(,R13)
         LM    R14,R12,12(R13)
         XR    R15,R15
         BR    R14
*
VALUE    DC    F'1234567'
DWORD    DS    D
MSG      DC    AL2(L'MSGTEXT+L'EDITED)
MSGTEXT  DC    C'VALUE: '
EDITED   DS    CL8
MASK     DC    X'4020202020202120'
SAVEAREA DC    18F'0'
         YREGS
         END   EDIT01
  • CVD needs an 8-byte doubleword. The last 4 bytes (DWORD+4) hold 7 digits and the sign.
  • In the mask, X'40' is the fill character, each X'20' takes a digit and X'21' marks where zeros start to show.
  • WTO TEXT= points to a halfword with the length, followed by the text. The console shows VALUE: 1234567.

Complete programs

Three whole programs that solve a real problem. The full source of each one is right here on the page, with numbered lines: just read, select and copy.

Go: SYSNAME, the system name read from the CVT

Go runs on z/OS too. This program reads system storage the same way IPLINFO does in REXX: it starts at the PSA, follows the pointer to the CVT and copies the CVTSNAME field.

Language
Go for z/OS (GOOS=zos, GOARCH=s390x)
Runs on
z/OS UNIX, from the shell or under BPXBATCH
Reads
PSA +X'10' → CVT, CVT +X'154' → CVTSNAME
Output
the system name, for example SYS1

How it works

  • Address 16 (X'10') of the PSA holds the pointer to the CVT. The PSA is mapped at address zero in every address space, so any program can read that pointer.
  • peek turns an address into a byte slice with unsafe.Slice, without copying anything. peek32 reads 4 bytes and clears the high-order bit, the AMODE 31 flag, before using the value as an address.
  • z/Architecture is big-endian, and so are the pointers stored in the PSA and the CVT. That is why reading the uint32 directly already gives the right address.
  • CVTSNAME is in EBCDIC (IBM-1047). The e2a function converts only the characters that can appear in a system name: letters, digits, $, #, @ and the blank. Anything else becomes ?.
  • To build and run it on z/OS UNIX, with the IBM Open Enterprise SDK for Go installed: go build -o sysname main.go and then ./sysname.

main.go 71 lines

// sysname displays the z/OS system name by reading the CVT in main memory
// (same as IPLINFO REXX):
//
//	CVT      = C2d(Storage(10,4))           /* PSA+16 -> CVT       */
//	CVTSNAME = Storage(D2x(CVT + 340),8)    /* system name         */
//	GRSNAME  = Strip(CVTSNAME,'T')          /* del trailing blanks */
//	Say GRSNAME
//
// CVTSNAME is EBCDIC (IBM-1047).
package main

import (
	"fmt"
	"os"
	"strings"
	"unsafe"
)

const (
	psaCVTPtr = 0x10 // PSA: pointer to CVT
	cvtSName  = 340  // CVTSNAME, 8 chars
)

// peek returns n bytes of storage at the given address.
func peek(addr uintptr, n int) []byte {
	return unsafe.Slice((*byte)(unsafe.Pointer(addr)), n)
}

// peek32 reads a big-endian 4-byte pointer and strips the AMODE bit.
func peek32(addr uintptr) uintptr {
	return uintptr(*(*uint32)(unsafe.Pointer(addr)) & 0x7fffffff)
}

// e2a converts the IBM-1047 characters valid in a system name to ASCII.
func e2a(b []byte) string {
	var sb strings.Builder
	for _, c := range b {
		switch {
		case c >= 0xC1 && c <= 0xC9:
			sb.WriteByte('A' + c - 0xC1)
		case c >= 0xD1 && c <= 0xD9:
			sb.WriteByte('J' + c - 0xD1)
		case c >= 0xE2 && c <= 0xE9:
			sb.WriteByte('S' + c - 0xE2)
		case c >= 0xF0 && c <= 0xF9:
			sb.WriteByte('0' + c - 0xF0)
		case c == 0x40:
			sb.WriteByte(' ')
		case c == 0x5B:
			sb.WriteByte('$')
		case c == 0x7B:
			sb.WriteByte('#')
		case c == 0x7C:
			sb.WriteByte('@')
		default:
			sb.WriteByte('?')
		}
	}
	return sb.String()
}

func main() {
	cvt := peek32(psaCVTPtr)
	if cvt == 0 {
		fmt.Fprintln(os.Stderr, "CVT pointer is null")
		os.Exit(1)
	}

	sysName := strings.TrimRight(e2a(peek(cvt+cvtSName, 8)), " ")
	fmt.Println(sysName)
}

SMFREAL, right below, does the same read in assembler, in the IDENT routine.

HLASM: SMFREAL, CICS SMF records in real time

An HLASM started task that reads CICS SMF type 110 subtype 1 records straight from an SMF in-memory resource and sends them over TCP to a collector written in Go, without waiting for the SMF dump.

Language
HLASM, z/Architecture
Attributes
AMODE 31, RMODE 24, not reentrant
Tasks
SMFREAL (main), SMFRGET (getter) and SMFRSND (sender): one object, three load modules
Services
IFAMCON, IFAMGET and IFAMDSC (SMF in-memory, AMODE 64) and the z/OS UNIX callable services (BPX1xxx) for TCP
Input
DD SMFRCFG with KEY=VALUE
Output
DD SYSPRINT, the console and the TCP connection to the collector

How it works

  • The main task reads the configuration, makes sure there is only one instance per resource with a file lock, builds the buffer ring and ATTACHes the getter and the sender. Then it waits for operator commands.
  • The getter connects to the resource with IFAMCON and calls the blocking IFAMGET, which writes the record straight into the next free slot of the ring. Only type 110 subtype 1 records are published; the last dictionary (class 1) of each APPLID is cached.
  • The sender talks to the collector: it sends HELLO, replays the cached dictionaries and sends the records in batches, with a single WRITEV per batch. A slot is freed only when the collector confirms the record with an ACK, after the database commit.
  • The three tasks share the anchor that R9 points to. The sequence numbers AQHEAD, AQSENT and AQTAIL track what has been read, sent and acknowledged.
  • The IDENT routine follows the same path as the Go program: L R2,16(,0) gets the CVT, and CVTSNAME is at X'154'. The internal routines start with BAKR R14,0, which pushes the registers onto the linkage stack, and end with PR.
  • The IFAM services only accept AMODE 64. The IFACALL routine clears the high bit of the addresses with LLGTR, points R13 to an F4SA save area and turns on 64-bit mode with SAM64 only for the duration of the call.
  • Operator commands: F SMFREAL,STATUS, F SMFREAL,TRACE ON, F SMFREAL,TRACE OFF and P SMFREAL.

Configuration in SMFRCFG

One key per line, as KEY=VALUE, in columns 1 to 72. Keys that are left out keep their default value.

KeyDefaultMeaning
RESOURCEIFASMF.CICS110SMF in-memory resource the records come from.
HOST127.0.0.1IPv4 address of the collector.
PORT6110TCP port of the collector.
SLOTS204832 KB slots in the ring (16 to 32768).
WINDOW256Sent records that may wait for an ACK at the same time.
BATCH64Records per WRITEV (up to 120).
RETRY10Seconds between connection retries.
HEARTBEAT30Seconds without traffic before a heartbeat is sent.
ACKTIMEOUT60Seconds to wait for an ACK before reconnecting.
DRAIN15Seconds to drain the ring after STOP.
STATINT15Interval of the statistics in SYSPRINT (0 turns them off).
STATSEND30Interval of the status frame sent to the collector (0 turns it off).
TRACENY logs every record received.
MAXRECS0Stops after N records. For testing only.
LOCKFILE/tmp/smfreal.<resource>.lockLock file that prevents two instances on the same resource.

Routines

Each name links to the matching line in the source below.

Main task (SMFREAL)
  • MAIN startup, configuration, ATTACH of the subtasks and operator commands
  • IDENT system name, job, JOBID, start time and instance
  • DOMOD handles the MODIFY command received in the CIB
  • BREAKGET IFAMDSC from the main task, to release a blocked IFAMGET
  • SINGLE one instance per resource, with an FCNTL lock on a file
  • CFGDFLT default configuration
  • CFGREAD reads DD SMFRCFG (KEY=VALUE, columns 1 to 72)
  • CFGLINE handles one configuration record
  • CFGSET stores the value of a key in the anchor
  • CFGFIX applies limits, validates the host and builds the default lock file
  • SHOWCFG shows the configuration (SMFR002I)
Getter (SMFRGET)
  • SMFRGET IFAMCON and a blocking IFAMGET straight into the next ring slot
  • GOTREC record returned by IFAMGET, in the slot or in the scratch area
  • CLASSIFY accepts only SMF 110 subtype 1 and identifies the class
  • CACHEDIC keeps the last dictionary of each APPLID
  • COMMIT frame header and publishing the slot to the sender
  • DROPREC ring full: the record is dropped
Sender (SMFRSND)
  • SMFRSND TCP client: HELLO, record batches, ACKs and heartbeat
  • ACKS parses the 20-byte ACK frames
  • CONNECT socket, connect and options
  • CLOSEC closes the collector socket
  • HELLO HELLO frame and replay of the cached dictionaries
  • SENDFRM sends a control frame
  • SBATCH a batch of records in a single WRITEV
  • WVALL repeats WRITEV until the last byte is out
  • SENDSTAT status frame (KEY=VALUE in EBCDIC)
Shared routines
  • SHOWSTAT statistics in the log (SMFR030I to SMFR033I)
  • APPQUEUE appends QUEUED, INFLIGHT and ACKED to the message
  • IFACALL calls an IFAM service in AMODE 64
  • SLOTADR slot address for a sequence number
  • WAKEUP one byte on the pipe wakes up the sender's poll
  • NAP waits N seconds, in 1-second steps
  • NUMPARSE decimal text to 64-bit binary
  • IPPARSE IPv4 address A.B.C.D to binary
  • FMTTS local date and time, YYYY-MM-DD HH:MM:SS
  • APPTXT message building: APPTXT, APPFLD, APPDEC and friends
  • LOGOUT writes the message to SYSPRINT and, if requested, to the console
Static data
  • DATA constants, call parameters and DCBs
Anchor, the shared area (DSECT ANC)
  • ANC shared state, statistics and configuration

SMFREAL.asm 2521 lines

Skip the source and go to the next program


         TITLE 'SMFREAL - CICS SMF 110-1 REAL TIME FORWARDER (HLASM)'
*---------------------------------------------------------------------
* SMFREAL 2.0 - HLASM VERSION OF THE SMFREAL STARTED TASK
*
* READS CICS SMF 110 SUBTYPE 1 RECORDS FROM AN SMF IN-MEMORY RESOURCE
* (IFAMCON/IFAMGET/IFAMDSC, AMODE 64 SERVICES) AND FORWARDS THEM OVER
* TCP TO THE SMFREAL COLLECTOR (GO). SAME WIRE PROTOCOL, CONFIGURATION
* (DD SMFRCFG), MESSAGES AND OPERATOR COMMANDS AS THE C VERSION 1.3.
*
* TASKS (ONE OBJECT, THREE LOAD MODULES - SEE CBT.SMFREAL.JCL(BUILD))
*   SMFREAL  MAIN: CONFIG, SINGLE INSTANCE LOCK, RING, ATTACHES THE
*            SUBTASKS, OPERATOR COMMANDS (EXTRACT/QEDIT):
*              F SMFREAL,STATUS | TRACE ON | TRACE OFF  (APPL= OK)
*              P SMFREAL
*   SMFRGET  GETTER: IFAMCON + BLOCKING IFAMGET STRAIGHT INTO THE NEXT
*            FREE 32K SLOT OF THE RING, COMMITS ONLY 110-1 RECORDS AND
*            CACHES THE LAST DICTIONARY (CLASS 1) OF EVERY APPLID.
*   SMFRSND  SENDER: TCP CLIENT (Z/OS UNIX CALLABLE SERVICES). HELLO,
*            DICTIONARY REPLAY, BATCHES OF RECORDS IN ONE WRITEV,
*            CUMULATIVE ACKS, HEARTBEAT AND STATUS FRAMES. A SLOT IS
*            FREED ONLY WHEN THE COLLECTOR ACKS IT (DB COMMIT).
*
* ATTRIBUTES: AMODE 31, RMODE 24, NOT REENTRANT (EVERY TASK RUNS ITS
* OWN COPY OF THE MODULE; SHARED STATE LIVES IN THE ANCHOR, R9).
* THE IFAM SERVICES ARE CALLED IN AMODE 64 (SAM64) WITH A F4SA.
*
* REGISTERS: R12,R11,R10,R7,R6 BASES  R9 ANCHOR  R13 SAVE AREA
* INTERNAL ROUTINES: JAS R14,RTN / BAKR R14,0 ... PR (R2-R14 KEPT,
* RESULTS IN R15 AND R0).
*---------------------------------------------------------------------
*
*--------------------------------------------------------- MACROS ---
         MACRO
&L       ENT$
&L       STM   R14,R12,12(R13)
         LARL  R12,SMFREAL
         LAY   R11,4096(,R12)
         LAY   R10,4096(,R11)
         LAY   R7,4096(,R10)
         LAY   R6,4096(,R7)
         ST    R13,SAVEA+4
         LA    R13,SAVEA
         MEND
*
         MACRO
&L       MSG$
&L       XC    MSGLEN,MSGLEN
         MEND
*
         MACRO
&L       TXT$  &S
         LCLC  &A
&A       SETC  'T&SYSNDX'
&L       LARL  R1,&A
         LHI   R0,L'&A
         JAS   R14,APPTXT
TEXT     LOCTR
         DS    0H
&A       DC    C&S
SMFREAL  LOCTR
         MEND
*
         MACRO
&L       FLD$  &A,&N
&L       LA    R1,&A
         LHI   R0,&N
         JAS   R14,APPFLD
         MEND
*
         MACRO
&L       FLDH$ &A,&H
&L       LA    R1,&A
         LH    R0,&H
         JAS   R14,APPFLD
         MEND
*
         MACRO
&L       DEC$  &A
&L       LA    R1,&A
         JAS   R14,APPDEC
         MEND
*
         MACRO
&L       DECF$ &A
&L       LA    R1,&A
         JAS   R14,APPDECF
         MEND
*
         MACRO
&L       DECR$ &R
&L       STG   &R,DECTMP
         LA    R1,DECTMP
         JAS   R14,APPDEC
         MEND
*
         MACRO
&L       HEX$  &A,&N
&L       LA    R1,&A
         LHI   R0,&N
         JAS   R14,APPHEX
         MEND
*
         MACRO
&L       OUT$  &W
&L       LHI   R0,&W
         JAS   R14,LOGOUT
         MEND
*
         MACRO
&L       NOW$  &R
&L       STCK  TODW
         LG    &R,TODW
         SRLG  &R,&R,12
         MEND
*
         MACRO
&L       INC$  &F
&L       LG    R0,&F
         AGHI  R0,1
         STG   R0,&F
         MEND
*
         MACRO
&L       CLOSE$ &S
         LCLC  &A
&A       SETC  'C&SYSNDX'
&L       LARL  R1,&A
         LHI   R0,L'&A
         JAS   R14,CLOSEC
TEXT     LOCTR
         DS    0H
&A       DC    C&S
SMFREAL  LOCTR
         MEND
*
*--------------------------------------------------------- EQUATES --
SLOTSZ   EQU   32800              SLOT: LEN(4) HDR(20) DATA(32768)+8
SLDATA   EQU   24                 OFFSET OF THE SMF RECORD IN A SLOT
MAXREC   EQU   32768              LARGEST SMF RECORD
MAXDICT  EQU   64                 CACHED DICTIONARIES
IOVMAX   EQU   120                BPXYIOV IOV_MAX
MSGMAX   EQU   700                MESSAGE / FRAME TEXT BUFFER
RBUFSZ   EQU   1280               ACK RECEIVE BUFFER
EINTR    EQU   120
PT#HELLO EQU   1
PT#REC   EQU   2
PT#DICT  EQU   3
PT#HB    EQU   4
PT#STAT  EQU   5
PT#ACK   EQU   X'81'
*
SMFREAL  CSECT
SMFREAL  AMODE 31
SMFREAL  RMODE 24
         SYSSTATE ARCHLVL=2
DATA     LOCTR
TEXT     LOCTR
BUF      LOCTR
SMFREAL  LOCTR
         YREGS
         USING SMFREAL,R12,R11,R10,R7,R6
         USING ANC,R9
         ENTRY SMFRGET,SMFRSND
         J     MAIN
         DC    C'SMFREAL 2.0 HLASM &SYSDATE &SYSTIME '
*
***********************************************************************
*  MAIN TASK                                                          *
***********************************************************************
MAIN     ENT$
         MVC   RETC,=F'0'
         STORAGE OBTAIN,LENGTH=ANCLEN,LOC=31
         LR    R9,R1
         ST    R9,ANCP
         LR    R2,R9
         LHI   R3,ANCLEN
         SLR   R4,R4
         SLR   R5,R5
         MVCL  R2,R4               CLEAR THE ANCHOR
         MVC   ALOCKFD,=F'-1'
         MVC   AWAKER,=F'-1'
         MVC   AWAKEW,=F'-1'
         OPEN  (PRTDCB,OUTPUT),MODE=31
         TM    PRTDCB+(DCBOFLGS-IHADCB),DCBOFOPN
         JNO   MA010
         LA    R1,PRTDCB
         ST    R1,APRTDCB
MA010    JAS   R14,IDENT
         MSG$
         TXT$  'SMFR001I SMFREAL 2.0 STARTING ON '
         FLD$  ASYSN,8
         TXT$  ' JOB '
         FLD$  AJOBN,8
         TXT$  ' '
         FLD$  AJOBID,8
         OUT$  1
         MSG$
         TXT$  'SMFR001I MODIFY: F '
         FLD$  AJOBN,8
         TXT$  ',STATUS | TRACE ON | TRACE OFF (APPL= OPTIONAL)'
         OUT$  0
         JAS   R14,CFGDFLT
         JAS   R14,CFGREAD
         JAS   R14,CFGFIX
         JAS   R14,SHOWCFG
         ICM   R0,15,CFGBAD
         JZ    MA020
         MSG$
         TXT$  'SMFR004E '
         DECF$ CFGBAD
         TXT$  ' CONFIG ERRORS, CHECK SMFRCFG'
         OUT$  1
MA020    JAS   R14,SINGLE
         LTR   R15,R15
         JZ    MA030
         MVC   RETC,=F'8'
         J     MAEXIT
*                                         RING, DICTIONARIES, PIPE
MA030    L     R0,ASLOTS
         MSFI  R0,SLOTSZ
         STORAGE OBTAIN,LENGTH=(R0),LOC=31,COND=YES
         LTR   R15,R15
         JZ    MA040
         MSG$
         TXT$  'SMFR008E CANNOT ALLOCATE '
         DECF$ ASLOTS
         TXT$  ' SLOTS, CHECK REGION/MEMLIMIT'
         OUT$  1
         MVC   RETC,=F'12'
         J     MAEXIT
MA040    ST    R1,ARING
         L     R0,=A(MAXDICT*MAXREC)
         STORAGE OBTAIN,LENGTH=(R0),LOC=31,COND=YES
         LTR   R15,R15
         JNZ   MA041
         ST    R1,ADICTA
         LA    R2,ADICT
         LHI   R3,MAXDICT
MA042    ST    R1,12(,R2)          DATA POINTER OF EACH ENTRY
         AL    R1,=A(MAXREC)
         LA    R2,16(,R2)
         JCT   R3,MA042
         CALL  BPX1PIP,(AWAKER,AWAKEW,RV,RC,RSN),VL,MF=(E,CALLPL)
         L     R0,RV
         LTR   R0,R0
         JNM   MA050
MA041    MSG$
         TXT$  'SMFR008E STORAGE OR PIPE FAILED ERRNO='
         DECF$ RC
         OUT$  1
         MVC   RETC,=F'12'
         J     MAEXIT
*                                         OPERATOR COMMAND INTERFACE
MA050    EXTRACT ANSWER,FIELDS=COMM
         L     R8,ANSWER
         USING COM,R8
         QEDIT ORIGIN=COMCIBPT,CIBCTR=1
         ICM   R2,15,COMCIBPT      START CIB ?
         JZ    MA060
         QEDIT ORIGIN=COMCIBPT,BLOCK=(R2)
*                                         SUBTASKS
MA060    LA    R2,ASNDECB
         ATTACH EP=SMFRSND,ECB=(R2),PARAM=(ANCP),VL=1
         ST    R1,ASNDTCB
         LTR   R15,R15
         JNZ   MA061
         LA    R2,AGETECB
         ATTACH EP=SMFRGET,ECB=(R2),PARAM=(ANCP),VL=1
         ST    R1,AGETTCB
         LTR   R15,R15
         JZ    MA070
MA061    ST    R15,WORKF
         MSG$
         TXT$  'SMFR008E ATTACH FAILED RC='
         DECF$ WORKF
         OUT$  1
         MVC   RETC,=F'12'
         J     MASTOP
MA070    MSG$
         TXT$  'SMFR005I '
         FLD$  AJOBN,8
         TXT$  ' READY FOR COMMANDS'
         OUT$  1
*                                         COMMAND LOOP
MALOOP   L     R2,COMECBPT
         ST    R2,ECBL
         LA    R2,ASTOPECB
         ST    R2,ECBL+4
         LA    R2,AGETECB
         ST    R2,ECBL+8
         LA    R2,ASNDECB
         O     R2,=X'80000000'
         ST    R2,ECBL+12
         WAIT  1,ECBLIST=ECBL
         TM    ASTOPECB,X'40'      MAXRECS REACHED
         JO    MASTOP
         TM    AGETECB,X'40'
         JO    MADIED
         TM    ASNDECB,X'40'
         JO    MADIED
MACIB    ICM   R5,15,COMCIBPT
         JZ    MALOOP
         USING CIB,R5
         CLI   CIBVERB,CIBSTOP
         JNE   MACIB2
         MSG$
         TXT$  'SMFR042I STOP COMMAND ACCEPTED'
         OUT$  1
         QEDIT ORIGIN=COMCIBPT,BLOCK=(R5)
         J     MASTOP
MACIB2   CLI   CIBVERB,CIBMODFY
         JNE   MACIB3
         JAS   R14,DOMOD           R15=1: STOP REQUESTED
         LTR   R15,R15
         JZ    MACIB3
         QEDIT ORIGIN=COMCIBPT,BLOCK=(R5)
         J     MASTOP
MACIB3   QEDIT ORIGIN=COMCIBPT,BLOCK=(R5)
         J     MACIB
         DROP  R5
MADIED   MSG$
         TXT$  'SMFR044E A SUBTASK ENDED UNEXPECTEDLY: GETTER='
         HEX$  AGETECB,4
         TXT$  ' SENDER='
         HEX$  ASNDECB,4
         OUT$  1
         MVC   RETC,=F'12'
*                                         SHUTDOWN
MASTOP   MSG$
         TXT$  'SMFR043I SMFREAL STOPPING, DRAIN UP TO '
         DECF$ ADRAIN
         TXT$  'S'
         OUT$  1
         MVI   ASTOP,1
         JAS   R14,WAKEUP
         JAS   R14,BREAKGET
         ICM   R2,15,AGETTCB
         JZ    MAST10
         WAIT  ECB=AGETECB
         DETACH AGETTCB
MAST10   ICM   R2,15,ASNDTCB
         JZ    MAST20
         WAIT  ECB=ASNDECB
         DETACH ASNDTCB
MAST20   LHI   R1,1
         JAS   R14,SHOWSTAT
MAEXIT   MSG$
         TXT$  'SMFR099I SMFREAL ENDED RC='
         DECF$ RETC
         OUT$  1
         L     R0,ALOCKFD
         LTR   R0,R0
         JM    MAEX10
         CALL  BPX1CLO,(ALOCKFD,RV,RC,RSN),VL,MF=(E,CALLPL)
MAEX10   ICM   R0,15,APRTDCB
         JZ    MAEX20
         CLOSE (PRTDCB),MODE=31
MAEX20   L     R13,SAVEA+4
         L     R15,RETC
         L     R14,12(,R13)
         LM    R0,R12,20(R13)
         BR    R14
         DROP  R8
*
*---------------------------------------------------------------------
* IDENT - SYSNAME, JOBNAME, JOBID, START TIME, INSTANCE
*---------------------------------------------------------------------
IDENT    BAKR  R14,0
         L     R2,16(,0)           CVT
         MVC   ASYSN,X'154'(R2)    CVTSNAME
         L     R2,X'21C'(,0)       PSATOLD -> TCB
         L     R3,X'0C'(,R2)       TCBTIO
         MVC   AJOBN,0(R3)         TIOCNJOB
         MVC   AJOBID,=CL8' '
         L     R3,X'B4'(,R2)       TCBJSCB
         N     R3,=X'00FFFFFF'
         JZ    ID010
         ICM   R3,15,X'13C'(R3)    JSCBSSIB
         JZ    ID010
         MVC   AJOBID,X'0C'(R3)    SSIBJBID
ID010    STCK  AINST
         NOW$  R2
         STG   R2,ASTARTUS
         LA    R1,ASTARTT
         JAS   R14,FMTTS
         MVI   ASTARTT+10,C'T'
         PR
*
*---------------------------------------------------------------------
* DOMOD - MODIFY COMMAND IN THE CIB (R5). R15=1 TO STOP
*---------------------------------------------------------------------
DOMOD    BAKR  R14,0
         USING CIB,R5
         MVC   CMDW,BLANKS
         LH    R2,CIBDATLN
         LTR   R2,R2
         JNP   DM010
         CHI   R2,64
         JNH   *+8
         LHI   R2,64
         AHI   R2,-1
         EX    R2,DMMVC
DM010    OC    CMDW,BLANKS          UPPER CASE
         CLC   CMDW(5),=C'APPL='
         JNE   DM020
         MVC   CMDW(59),CMDW+5
         MVC   CMDW+59(5),BLANKS
DM020    CLI   CMDW,C' '            LEADING BLANKS
         JNE   DM030
         CLC   CMDW,BLANKS
         JE    DM030
         MVC   CMDW(63),CMDW+1
         MVI   CMDW+63,C' '
         J     DM020
DM030    CLC   CMDW(16),=CL16'STATUS'
         JE    DMSTAT
         CLC   CMDW(16),=CL16'STATS'
         JE    DMSTAT
         CLC   CMDW(16),=CL16'D'
         JE    DMSTAT
         CLC   CMDW(16),=CL16'TRACE ON'
         JE    DMTON
         CLC   CMDW(16),=CL16'TRACE=Y'
         JE    DMTON
         CLC   CMDW(16),=CL16'TRACE OFF'
         JE    DMTOFF
         CLC   CMDW(16),=CL16'TRACE=N'
         JE    DMTOFF
         CLC   CMDW(16),=CL16'STOP'
         JE    DMSTOP
         CLC   CMDW(16),=CL16'SHUTDOWN'
         JE    DMSTOP
         MSG$
         TXT$  'SMFR041E UNKNOWN COMMAND '''
         FLD$  CMDW,64
         TXT$  '''. USE F '
         FLD$  AJOBN,8
         TXT$  ',STATUS | TRACE ON | TRACE OFF OR P '
         FLD$  AJOBN,8
         OUT$  1
         J     DMRET0
DMSTAT   LHI   R1,1
         JAS   R14,SHOWSTAT
         J     DMRET0
DMTON    MVI   ATRACE,1
         MSG$
         TXT$  'SMFR040I TRACE IS ON'
         OUT$  1
         J     DMRET0
DMTOFF   MVI   ATRACE,0
         MSG$
         TXT$  'SMFR040I TRACE IS OFF'
         OUT$  1
         J     DMRET0
DMSTOP   LHI   R15,1
         PR
DMRET0   LHI   R15,0
         PR
DMMVC    MVC   CMDW(0),CIBDATA
         DROP  R5
*
*---------------------------------------------------------------------
* BREAKGET - IFAMDSC FROM THE MAIN TASK: WAKES A BLOCKED IFAMGET
*---------------------------------------------------------------------
BREAKGET BAKR  R14,0
         CLI   ASMFCON,0
         JE    BG010
         XC    DSPB,DSPB
         MVC   DSPB(4),=C'DSPB'
         MVC   DSPB+4(2),=H'24'
         MVI   DSPB+7,1
         MVC   DSPB+8(16),ATOKEN
         L     R15,=V(IFAMDSC)
         LA    R1,PLDSC
         JAS   R14,IFACALL
         MSG$
         TXT$  'SMFR019I STOP DISCONNECT RC='
         HEX$  IRC+3,1
         TXT$  ' RSN='
         HEX$  IRSN+2,2
         OUT$  0
BG010    PR
*
*---------------------------------------------------------------------
* SINGLE - ONE SMFREAL PER RESOURCE: FCNTL LOCK ON THE LOCK FILE.
*          R15 = 0 OK, 8 ANOTHER INSTANCE / ERROR
*---------------------------------------------------------------------
SINGLE   BAKR  R14,0
         CLC   ALOCKL,=H'4'
         JNE   SI010
         CLC   ALOCK(4),=C'NONE'
         JNE   SI010
         MSG$
         TXT$  'SMFR009W LOCKFILE=NONE: SINGLE INSTANCE CHECK OFF'
         OUT$  1
         J     SIOK
SI010    LH    R0,ALOCKL
         ST    R0,WORKF
         CALL  BPX1OPN,(WORKF,ALOCK,FOPNOPT,FMODE,RV,RC,RSN),VL,MF=(E, X
               CALLPL)
         L     R0,RV
         LTR   R0,R0
         JNM   SI020
         MSG$
         TXT$  'SMFR009E CANNOT OPEN LOCK FILE '
         FLDH$ ALOCK,ALOCKL
         TXT$  ' ERRNO='
         DECF$ RC
         OUT$  1
         J     SIBAD
SI020    ST    R0,ALOCKFD
         CALL  BPX1FCM,(ALOCKFD,FMODE,RV2,RC2,RSN2),VL,MF=(E,CALLPL)
         XC    BRLK,BRLK
         MVC   BRLK(2),=H'2'       F_WRLCK, WHENCE 0, START 0, LEN 0
         CALL  BPX1FCT,(ALOCKFD,FSETLK,BRLKPTR,RV,RC,RSN),VL,MF=(E,    X
               CALLPL)
         L     R0,RV
         LTR   R0,R0
         JNM   SI050
*                                         ALREADY LOCKED
         LARL  R2,HOLDBUF
         MVC   0(255,R2),BLANKS
         ST    R2,BUFPTRW
         CALL  BPX1LSK,(ALOCKFD,DZERO,FZERO,RVD,RC2,RSN2),VL,MF=(E,    X
               CALLPL)
         CALL  BPX1RED,(ALOCKFD,BUFPTRW,FZERO,F255,RV2,RC2,RSN2),VL,   X
               MF=(E,CALLPL)
         LHI   R3,0
         L     R4,RV2
         LTR   R4,R4
         JNP   SI040
         LR    R1,R2               CUT AT THE NEWLINE (X'15')
SI030    CLI   0(R1),X'15'
         JE    SI040
         LA    R1,1(,R1)
         AHI   R3,1
         JCT   R4,SI030
SI040    STH   R3,HOLDLEN
         XC    BRLK,BRLK
         MVC   BRLK(2),=H'2'
         CALL  BPX1FCT,(ALOCKFD,FGETLK,BRLKPTR,RV2,RC2,RSN2),VL,MF=(E, X
               CALLPL)
         MSG$
         TXT$  'SMFR009E '
         FLDH$ ARES,ARESL
         TXT$  ' IS ALREADY READ BY ANOTHER SMFREAL (PID '
         DECF$ BRLK+20
         TXT$  ') - THIS ONE ENDS'
         OUT$  1
         LH    R0,HOLDLEN
         LTR   R0,R0
         JZ    SI045
         MSG$
         TXT$  'SMFR009E ACTIVE: '
         LARL  R1,HOLDBUF
         LH    R0,HOLDLEN
         JAS   R14,APPFLD
         OUT$  1
SI045    CALL  BPX1CLO,(ALOCKFD,RV2,RC2,RSN2),VL,MF=(E,CALLPL)
         MVC   ALOCKFD,=F'-1'
         J     SIBAD
*                                         LOCKED: WRITE WHO WE ARE
SI050    CALL  BPX1GPI,(WORKF),VL,MF=(E,CALLPL)
         MSG$
         TXT$  'JOB '
         FLD$  AJOBN,8
         TXT$  ' '
         FLD$  AJOBID,8
         TXT$  ' PID '
         DECF$ WORKF
         TXT$  ' SYSTEM '
         FLD$  ASYSN,8
         TXT$  ' SINCE '
         LA    R1,TSWORK
         JAS   R14,FMTTS
         LA    R1,TSWORK
         LHI   R0,19
         JAS   R14,APPTXT
         LA    R1,NLCHAR
         LHI   R0,1
         JAS   R14,APPTXT
         CALL  BPX1FTR,(ALOCKFD,DZERO,RV2,RC2,RSN2),VL,MF=(E,CALLPL)
         CALL  BPX1LSK,(ALOCKFD,DZERO,FZERO,RVD,RC2,RSN2),VL,MF=(E,    X
               CALLPL)
         LARL  R2,MSGBUF
         ST    R2,BUFPTRW
         CALL  BPX1WRT,(ALOCKFD,BUFPTRW,FZERO,MSGLEN,RV2,RC2,RSN2),VL, X
               MF=(E,CALLPL)
         MSG$
         TXT$  'SMFR009I SINGLE INSTANCE LOCK '
         FLDH$ ALOCK,ALOCKL
         TXT$  ' ACQUIRED'
         OUT$  0
SIOK     LHI   R15,0
         PR
SIBAD    LHI   R15,8
         PR
*
*---------------------------------------------------------------------
* CFGDFLT - DEFAULT CONFIGURATION
*---------------------------------------------------------------------
CFGDFLT  BAKR  R14,0
         MVC   ARESL,=H'14'
         MVC   ARES,=CL26'IFASMF.CICS110'
         MVC   AHOSTL,=H'9'
         MVC   AHOST(9),=C'127.0.0.1'
         MVC   APORT,=F'6110'
         MVC   ASLOTS,=F'2048'
         MVC   AWINDOW,=F'256'
         MVC   ABATCH,=F'64'
         MVC   ARETRY,=F'10'
         MVC   AHBEAT,=F'30'
         MVC   AACKTO,=F'60'
         MVC   ADRAIN,=F'15'
         MVC   ASTATINT,=F'15'
         MVC   ASTATSND,=F'30'
         MVI   ATRACE,0
         XC    AMAXREC,AMAXREC
         XC    ALOCKL,ALOCKL
         XC    CFGBAD,CFGBAD
         PR
*
*---------------------------------------------------------------------
* CFGREAD - READ DD SMFRCFG (KEY=VALUE, COLUMNS 1-72)
*---------------------------------------------------------------------
CFGREAD  BAKR  R14,0
         OPEN  (CFGDCB,INPUT),MODE=31
         TM    CFGDCB+(DCBOFLGS-IHADCB),DCBOFOPN
         JO    CR010
         MSG$
         TXT$  'SMFR003W CONFIG DD SMFRCFG NOT AVAILABLE, '
         TXT$  'USING DEFAULTS'
         OUT$  1
         PR
CR010    LARL  R8,CFGREC
         MVC   0(80,R8),BLANKS
         GET   CFGDCB,(R8)
         JAS   R14,CFGLINE
         J     CR010
CFGEOF   CLOSE (CFGDCB),MODE=31
         PR
*
*---------------------------------------------------------------------
* CFGLINE - ONE CONFIG RECORD (R8)
*---------------------------------------------------------------------
CFGLINE  BAKR  R14,0
         MVC   LINE,0(R8)
         LA    R2,LINE             FIRST NON BLANK
         LHI   R3,72
CL010    CLI   0(R2),C' '
         JNE   CL020
         LA    R2,1(,R2)
         JCT   R3,CL010
         PR                        EMPTY LINE
CL020    CLI   0(R2),C'*'
         JE    CLRET
         CLC   0(2,R2),=C'/*'
         JE    CLRET
         LA    R8,LINE+71          LAST NON BLANK
CL030    CLI   0(R8),C' '
         JNE   CL040
         BCTR  R8,0
         J     CL030
CL040    LA    R8,1(,R8)           R8 = END OF TEXT
         LR    R1,R2               FIND '='
CL050    CR    R1,R8
         JNL   CLNOEQ
         CLI   0(R1),C'='
         JE    CL060
         LA    R1,1(,R1)
         J     CL050
CL060    LR    R3,R1               KEY = R2 .. R3 (TRIMMED)
CL065    CR    R3,R2
         JNH   CL070
         LR    R4,R3
         BCTR  R4,0
         CLI   0(R4),C' '
         JNE   CL070
         LR    R3,R4
         J     CL065
CL070    SR    R3,R2               R3 = KEY LENGTH
         LA    R4,1(,R1)           VALUE START
CL075    CR    R4,R8
         JNL   CL080
         CLI   0(R4),C' '
         JNE   CL080
         LA    R4,1(,R4)
         J     CL075
CL080    LR    R5,R8
         SR    R5,R4               R5 = VALUE LENGTH (>=0)
         MVC   KEYW,BLANKS
         LTR   R3,R3
         JNP   CLBADK
         CHI   R3,16
         JH    CLBADK
         LR    R1,R3
         BCTR  R1,0
         EX    R1,CLMVKEY
         OC    KEYW,BLANKS         UPPER CASE
         JAS   R14,CFGSET
CLRET    PR
CLNOEQ   MSG$
         TXT$  'SMFR004E CONFIG LINE IGNORED: '
         LR    R1,R2
         LR    R0,R8
         SR    R0,R2
         JAS   R14,APPTXT
         OUT$  1
         J     CLERR
CLBADK   MSG$
         TXT$  'SMFR004E INVALID CONFIG KEY'
         OUT$  1
CLERR    L     R0,CFGBAD
         AHI   R0,1
         ST    R0,CFGBAD
         PR
CLMVKEY  MVC   KEYW(0),0(R2)
*
*---------------------------------------------------------------------
* CFGSET - KEYW = KEY, R4/R5 = VALUE ADDRESS/LENGTH
*---------------------------------------------------------------------
CFGSET   BAKR  R14,0
         LA    R2,CFGTAB
CS010    CLI   0(R2),0
         JE    CSUNK
         CLC   KEYW(10),1(R2)
         JNE   CS015
         CLC   KEYW+10(6),BLANKS
         JE    CS020
CS015    LA    R2,CFGTABL(,R2)
         J     CS010
CS020    LH    R3,12(,R2)          OFFSET IN THE ANCHOR
         AR    R3,R9
         CLI   11(R2),C'S'
         JE    CSSTR
         CLI   11(R2),C'Y'
         JE    CSFLAG
         LR    R1,R4
         LR    R0,R5
         JAS   R14,NUMPARSE        R15 = VALUE, R0 = RC
         LTR   R0,R0
         JNZ   CSBADN
         CLI   11(R2),C'D'
         JE    CSDBL
         CLGFI R15,X'7FFFFFFF'
         JH    CSBADN
         ST    R15,0(,R3)
         PR
CSDBL    STG   R15,0(,R3)
         PR
CSFLAG   MVI   0(R3),0
         LTR   R5,R5
         JNP   CSRET
         CLI   0(R4),C'Y'
         JE    CSFY
         CLI   0(R4),C'y'
         JNE   CSRET
CSFY     MVI   0(R3),1
CSRET    PR
CSSTR    LH    R1,14(,R2)          MAX LENGTH
         CR    R5,R1
         JNH   *+6
         LR    R5,R1
         STH   R5,0(,R3)
         LA    R0,2(,R3)           TARGET
         LR    R14,R4              SOURCE
         LR    R15,R5
         LR    R1,R5
         MVCL  R0,R14
         PR
CSBADN   MSG$
         TXT$  'SMFR004E INVALID NUMBER FOR '
         FLD$  KEYW,16
         OUT$  1
         J     CSERR
CSUNK    MSG$
         TXT$  'SMFR004E UNKNOWN CONFIG KEY '
         FLD$  KEYW,16
         OUT$  1
CSERR    L     R0,CFGBAD
         AHI   R0,1
         ST    R0,CFGBAD
         PR
*
*---------------------------------------------------------------------
* CFGFIX - LIMITS, HOST ADDRESS, DEFAULT LOCK FILE
*---------------------------------------------------------------------
CFGFIX   BAKR  R14,0
         L     R2,ASLOTS
         CHI   R2,16
         JNL   *+8
         LHI   R2,16
         C     R2,=F'32768'
         JNH   *+8
         L     R2,=F'32768'
         ST    R2,ASLOTS
         L     R3,AWINDOW
         CHI   R3,1
         JNL   *+8
         LHI   R3,1
         CR    R3,R2
         JNH   *+6
         LR    R3,R2
         ST    R3,AWINDOW
         L     R3,ABATCH
         CHI   R3,1
         JNL   *+8
         LHI   R3,1
         CHI   R3,IOVMAX
         JNH   *+8
         LHI   R3,IOVMAX
         ST    R3,ABATCH
         L     R3,ARETRY
         CHI   R3,1
         JNL   *+8
         LHI   R3,1
         ST    R3,ARETRY
         L     R3,AHBEAT
         CHI   R3,5
         JNL   *+8
         LHI   R3,5
         ST    R3,AHBEAT
         SLL   R3,1
         C     R3,AACKTO
         JNH   *+8
         ST    R3,AACKTO
         L     R3,APORT
         LTR   R3,R3
         JNP   CF010
         C     R3,=F'65535'
         JNH   CF020
CF010    MSG$
         TXT$  'SMFR004E INVALID PORT, USING 6110'
         OUT$  1
         MVC   APORT,=F'6110'
         L     R0,CFGBAD
         AHI   R0,1
         ST    R0,CFGBAD
CF020    CLC   ARESL,=H'0'
         JNE   CF025
         MSG$
         TXT$  'SMFR004E EMPTY RESOURCE, USING IFASMF.CICS110'
         OUT$  1
         MVC   ARESL,=H'14'
         MVC   ARES,=CL26'IFASMF.CICS110'
         L     R0,CFGBAD
         AHI   R0,1
         ST    R0,CFGBAD
CF025    LA    R1,AHOST
         LH    R0,AHOSTL
         JAS   R14,IPPARSE
         LTR   R0,R0
         JZ    CF030
         MSG$
         TXT$  'SMFR004E HOST MUST BE AN IPV4 ADDRESS: '
         FLDH$ AHOST,AHOSTL
         OUT$  1
         L     R0,CFGBAD
         AHI   R0,1
         ST    R0,CFGBAD
         L     R15,=X'7F000001'    127.0.0.1
CF030    ST    R15,AHOSTIP
         CLC   ALOCKL,=H'0'        DEFAULT /tmp/smfreal.<RES>.lock
         JNE   CF040
         MVC   ALOCK(13),=C'/tmp/smfreal.'
         LA    R2,ALOCK+13
         LH    R3,ARESL
         LR    R1,R3
         BCTR  R1,0
         EX    R1,CFMVRES
         AR    R2,R3
         MVC   0(5,R2),=C'.lock'
         LA    R3,18(,R3)
         STH   R3,ALOCKL
CF040    PR
CFMVRES  MVC   0(0,R2),ARES
*
*---------------------------------------------------------------------
* SHOWCFG - SMFR002I
*---------------------------------------------------------------------
SHOWCFG  BAKR  R14,0
         MSG$
         TXT$  'SMFR002I RESOURCE='
         FLDH$ ARES,ARESL
         TXT$  ' HOST='
         FLDH$ AHOST,AHOSTL
         TXT$  ' PORT='
         DECF$ APORT
         TXT$  ' SLOTS='
         DECF$ ASLOTS
         TXT$  ' WINDOW='
         DECF$ AWINDOW
         TXT$  ' BATCH='
         DECF$ ABATCH
         OUT$  0
         MSG$
         TXT$  'SMFR002I RETRY='
         DECF$ ARETRY
         TXT$  ' HEARTBEAT='
         DECF$ AHBEAT
         TXT$  ' ACKTIMEOUT='
         DECF$ AACKTO
         TXT$  ' DRAIN='
         DECF$ ADRAIN
         TXT$  ' STATINT='
         DECF$ ASTATINT
         TXT$  ' STATSEND='
         DECF$ ASTATSND
         TXT$  ' TRACE='
         JAS   R14,APPYN
         TXT$  ' MAXRECS='
         DEC$  AMAXREC
         OUT$  0
         PR
*
***********************************************************************
*  GETTER SUBTASK (SMFRGET)                                           *
***********************************************************************
SMFRGET  ENT$
         L     R9,0(,R1)           -> ANCP OF THE MAIN TASK
         L     R9,0(,R9)           ANCHOR
         STORAGE OBTAIN,LENGTH=MAXREC,LOC=31
         ST    R1,SCRATCH
         XC    LASTMISS,LASTMISS
*                                         CONNECT
GE010    CLI   ASTOP,0
         JNE   GEEND
         XC    CNPB,CNPB
         MVC   CNPB(4),=C'CNPB'
         MVC   CNPB+4(2),=H'106'
         MVI   CNPB+7,1
         MVC   CNPB+12(2),ARESL
         MVC   CNPB+14(26),BLANKS
         LH    R1,ARESL
         BCTR  R1,0
         EX    R1,GEMVRES
         L     R15,=V(IFAMCON)
         LA    R1,PLCON
         JAS   R14,IFACALL
         ICM   R0,15,IRC
         JZ    GE020
         MSG$
         TXT$  'SMFR011E IFAMCON '
         FLDH$ ARES,ARESL
         TXT$  ' RC='
         HEX$  IRC+3,1
         TXT$  ' RSN='
         HEX$  IRSN+2,2
         TXT$  ', RETRY IN '
         DECF$ ARETRY
         TXT$  'S'
         OUT$  1
         L     R1,ARETRY
         JAS   R14,NAP
         J     GE010
GE020    MVC   ATOKEN,CNPB+56
         MVI   ASMFCON,1
         INC$  SSMFCON
         MSG$
         TXT$  'SMFR010I CONNECTED TO IN-MEMORY RESOURCE '
         FLDH$ ARES,ARESL
         OUT$  1
         XC    GTPB,GTPB
         MVC   GTPB(4),=C'GTPB'
         MVC   GTPB+4(2),=H'64'
         MVI   GTPB+7,1            FLAGS 0 = BLOCKING
         MVC   GTPB+16(16),CNPB+56
         MVC   GTPB+32(4),=A(MAXREC)
*                                         GET LOOP
GE030    CLI   ASTOP,0
         JNE   GEDSC
         XC    SLOTP,SLOTP         RESERVE THE NEXT SLOT
         LG    R2,AQHEAD
         LG    R3,AQTAIL
         LGR   R4,R2
         SGR   R4,R3
         LLGF  R5,ASLOTS
         CLGR  R4,R5
         JNL   GE040               RING FULL
         LGR   R1,R2
         AGHI  R1,1
         STG   R1,NREC
         JAS   R14,SLOTADR
         ST    R15,SLOTP
         LA    R15,SLDATA(,R15)
         ST    R15,TARGET
         J     GE050
GE040    MVC   TARGET,SCRATCH
GE050    XC    GTPB+56(4),GTPB+56
         MVC   GTPB+60(4),TARGET
         XC    GTPB+52(4),GTPB+52
         L     R15,=V(IFAMGET)
         LA    R1,PLGET
         JAS   R14,IFACALL
         ICM   R0,15,IRC
         JNZ   GE060
         JAS   R14,GOTREC
         J     GE030
GE060    CLC   IRC,=F'4'
         JNE   GE080
         CLC   IRSN,=X'00000401'   MISSED DATA
         JNE   GE070
         INC$  SMISSED
         LG    R2,SMISSED
         LG    R3,LASTMISS
         LTGR  R3,R3
         JZ    GE065
         SGR   R2,R3
         CGHI  R2,100
         JL    GE066
GE065    MVC   LASTMISS,SMISSED
         MSG$
         TXT$  'SMFR012W IFAMGET MISSED DATA ('
         DEC$  SMISSED
         TXT$  ')'
         OUT$  1
GE066    JAS   R14,GOTREC
         J     GE030
GE070    CLC   IRSN,=X'00000405'   STOP IN PROGRESS
         JE    GEDSC
         CLC   IRSN,=X'00000406'
         JE    GEDSC
         CLC   IRSN,=X'00000408'
         JE    GEDSC
GE080    MSG$
         TXT$  'SMFR013E IFAMGET RC='
         HEX$  IRC+3,1
         TXT$  ' RSN='
         HEX$  IRSN+2,2
         OUT$  1
*                                         DISCONNECT
GEDSC    MVI   ASMFCON,0
         XC    DSPB,DSPB
         MVC   DSPB(4),=C'DSPB'
         MVC   DSPB+4(2),=H'24'
         MVI   DSPB+7,1
         MVC   DSPB+8(16),CNPB+56
         L     R15,=V(IFAMDSC)
         LA    R1,PLDSC
         JAS   R14,IFACALL
         MSG$
         TXT$  'SMFR018I DISCONNECTED FROM '
         FLDH$ ARES,ARESL
         TXT$  ' RC='
         HEX$  IRC+3,1
         TXT$  ' RSN='
         HEX$  IRSN+2,2
         OUT$  1
         CLI   ASTOP,0
         JNE   GEEND
         L     R1,ARETRY
         JAS   R14,NAP
         J     GE010
GEEND    L     R13,SAVEA+4
         LM    R14,R12,12(R13)
         SLR   R15,R15
         BR    R14
GEMVRES  MVC   CNPB+14(0),ARES
*
*---------------------------------------------------------------------
* GOTREC - RECORD RETURNED BY IFAMGET IN TARGET (SLOT OR SCRATCH)
*---------------------------------------------------------------------
GOTREC   BAKR  R14,0
         L     R4,GTPB+52          RETURNED LENGTH
         LTR   R4,R4
         JNP   GRRET
         C     R4,=A(MAXREC)
         JH    GRRET
         L     R2,TARGET
         JAS   R14,CLASSIFY
         LTR   R15,R15
         JZ    GRRET
         ICM   R3,15,SLOTP
         JZ    GR010
         JAS   R14,COMMIT
         J     GR020
GR010    JAS   R14,DROPREC
GR020    LG    R0,AMAXREC          MAXRECS (TEST ONLY)
         LTGR  R0,R0
         JZ    GRRET
         CLI   ASTOP,0
         JNE   GRRET
         LG    R1,SSUB1
         CLGR  R1,R0
         JL    GRRET
         MSG$
         TXT$  'SMFR017I MAXRECS='
         DEC$  AMAXREC
         TXT$  ' REACHED'
         OUT$  1
         MVI   ASTOP,1
         POST  ASTOPECB
GRRET    PR
*
*---------------------------------------------------------------------
* CLASSIFY - R2 = RECORD, R4 = LENGTH. R15 = 1 TO FORWARD IT
*---------------------------------------------------------------------
CLASSIFY BAKR  R14,0
         INC$  SGETS
         CHI   R4,44
         JL    CLOTHER
         CLI   5(R2),110           TYPE 110
         JNE   CLOTHER
         CLC   22(2,R2),=H'1'      SUBTYPE 1
         JNE   CLOTHER
         L     R5,28(,R2)          OFFSET OF THE PRODUCT SECTION
         CL    R5,=F'44'
         JL    CLOTHER
         LA    R1,24(,R5)
         CLR   R1,R4
         JH    CLOTHER
         INC$  SSUB1
         AR    R5,R2               R5 -> PRODUCT SECTION
         LH    R8,22(,R5)          CLASS
         ST    R8,CLSW
         CHI   R8,1
         JNE   CF300
         INC$  SDICTS
         JAS   R14,CACHEDIC
         MSG$
         TXT$  'SMFR015I DICTIONARY RECEIVED FOR APPLID '
         FLD$  10(R5),8
         OUT$  1
         J     CF310
CF300    CHI   R8,3
         JNE   CF310
         INC$  SPERF
CF310    CLI   ATRACE,0
         JE    CF320
         ST    R4,LENW
         MSG$
         TXT$  'SMFR016I RECORD LEN='
         DECF$ LENW
         TXT$  ' APPLID='
         FLD$  10(R5),8
         TXT$  ' CLASS='
         DECF$ CLSW
         OUT$  0
CF320    LHI   R15,1
         PR
CLOTHER  INC$  SOTHER
         LHI   R15,0
         PR
*
*---------------------------------------------------------------------
* CACHEDIC - KEEP THE LAST DICTIONARY OF THE APPLID AT 10(R5)
*            R2 = RECORD, R4 = LENGTH
*---------------------------------------------------------------------
CACHEDIC BAKR  R14,0
         ENQ   (QNAME,RNDICT,E,8,STEP),RET=NONE
         LA    R3,ADICT
         ICM   R8,15,ADICTN
         JZ    CD020
CD010    CLC   0(8,R3),10(R5)
         JE    CD040
         LA    R3,16(,R3)
         JCT   R8,CD010
CD020    L     R8,ADICTN           NEW ENTRY (R3 = ENTRY N)
         CHI   R8,MAXDICT
         JNL   CD030
         AHI   R8,1
         ST    R8,ADICTN
         J     CD040
CD030    L     R8,ADICTX           FULL: REUSE IN ROTATION
         LR    R3,R8
         SLL   R3,4
         LA    R3,ADICT(R3)
         AHI   R8,1
         N     R8,=F'63'
         ST    R8,ADICTX
CD040    MVC   0(8,R3),10(R5)
         ST    R4,8(,R3)
         L     R0,12(,R3)
         LR    R1,R4
         LR    R14,R2
         LR    R15,R4
         MVCL  R0,R14
         DEQ   (QNAME,RNDICT,8,STEP),RET=NONE
         PR
*
*---------------------------------------------------------------------
* COMMIT - R3 = SLOT, R4 = LENGTH, NREC = SEQUENCE. FRAME HEADER IN
*          FRONT OF THE DATA, PUBLISH, WAKE THE SENDER IF IT WAITS
*---------------------------------------------------------------------
COMMIT   BAKR  R14,0
         MVC   4(4,R3),MAGIC
         MVI   8(R3),1             VERSION
         MVI   9(R3),PT#REC
         XC    10(2,R3),10(R3)
         MVC   12(8,R3),NREC
         ST    R4,20(,R3)
         ST    R4,0(,R3)
         LG    R0,NREC
         STG   R0,AQHEAD
         BCR   15,0                STORE -> LOAD ORDER (SEE SENDER)
         ICM   R0,15,AWAITING
         JZ    CM010
         LHI   R0,1
         LHI   R1,0
         CS    R0,R1,AWAITING
         JNE   CM010
         INC$  SWAKES
         JAS   R14,WAKEUP
CM010    PR
*
*---------------------------------------------------------------------
* DROPREC - RING FULL
*---------------------------------------------------------------------
DROPREC  BAKR  R14,0
         INC$  SDROP
         LG    R3,SDROP
         CGHI  R3,1
         JE    DR010
         LGHI  R2,0
         LGHI  R4,1000
         DLGR  R2,R4
         LTGR  R2,R2
         JNZ   DR020
DR010    MSG$
         TXT$  'SMFR014W RING FULL, '
         DEC$  SDROP
         TXT$  ' RECORDS DROPPED'
         OUT$  1
DR020    PR
*
***********************************************************************
*  SENDER SUBTASK (SMFRSND)                                           *
***********************************************************************
SMFRSND  ENT$
         L     R9,0(,R1)
         L     R9,0(,R9)
         CALL  BPX1SPM,(FZERO,SIGPTR,FZERO,RV,RC,RSN),VL,MF=(E,CALLPL)
         L     R0,=A(MAXDICT*MAXREC)
         STORAGE OBTAIN,LENGTH=(R0),LOC=31
         ST    R1,REPLAY
         MVC   FD,=F'-1'
         XC    RLEN,RLEN
         XC    FAILS,FAILS
         XC    STOPAT,STOPAT
         XC    LASTCLOS,LASTCLOS
         XC    LASTSTS,LASTSTS
         NOW$  R2
         STG   R2,LASTSTAT
         STG   R2,LASTSEND
         STG   R2,LASTACK
*                                         MAIN LOOP
SE010    NOW$  R2
         STG   R2,NOWUS
         LG    R3,AQHEAD
         STG   R3,HEADL
         LG    R3,AQSENT
         STG   R3,SENTL
         LG    R3,AQTAIL
         STG   R3,TAILL
         CLI   ASTOP,0
         JE    SE020
         LG    R3,STOPAT
         LTGR  R3,R3
         JNZ   SE015
         LLGF  R3,ADRAIN
         MSGFI R3,1000000
         AGR   R3,R2
         STG   R3,STOPAT
SE015    CLC   TAILL,HEADL
         JE    SEEND
         ICM   R0,15,FD
         JM    SEEND
         CG    R2,STOPAT
         JNL   SEEND
SE020    ICM   R3,15,ASTATINT      STATISTICS IN SYSPRINT
         JZ    SE030
         LLGFR R3,R3
         MSGFI R3,60000000
         AG    R3,LASTSTAT
         CGR   R2,R3
         JL    SE030
         LHI   R1,0
         JAS   R14,SHOWSTAT
         MVC   LASTSTAT,NOWUS
*                                         (RE)CONNECT
SE030    ICM   R0,15,FD
         JNM   SE100
         LG    R3,LASTCLOS
         LTGR  R3,R3
         JZ    SE040
         LLGF  R4,ARETRY
         MSGFI R4,1000000
         AGR   R4,R3               END OF THE BACKOFF
         SGR   R4,R2
         JNP   SE040
         LGR   R1,R4
         LGHI  R0,0
         DLG   R0,=FD'1000000'
         AHI   R1,1
         JAS   R14,NAP
         J     SE010
SE040    JAS   R14,CONNECT
         ST    R15,FD
         LTR   R15,R15
         JNM   SE050
         L     R3,FAILS
         AHI   R3,1
         ST    R3,FAILS
         CHI   R3,1
         JE    SE045
         SLR   R2,R2
         D     R2,=F'30'
         LTR   R2,R2
         JNZ   SE046
SE045    MSG$
         TXT$  'SMFR021W COLLECTOR '
         FLDH$ AHOST,AHOSTL
         TXT$  ':'
         DECF$ APORT
         TXT$  ' UNAVAILABLE, RETRY EVERY '
         DECF$ ARETRY
         TXT$  'S'
         OUT$  1
SE046    L     R1,ARETRY
         JAS   R14,NAP
         J     SE010
SE050    JAS   R14,HELLO
         LTR   R15,R15
         JZ    SE060
         CLOSE$ 'HELLO FAILED'
         L     R1,ARETRY
         JAS   R14,NAP
         J     SE010
SE060    XC    FAILS,FAILS
         INC$  SCONNECT
         MVI   ACOLLCON,1
         XC    RLEN,RLEN
         MVC   AQSENT,AQTAIL       RESEND UNACKED RECORDS
         MVC   SENTL,AQTAIL
         NOW$  R2
         STG   R2,NOWUS
         STG   R2,LASTSEND
         STG   R2,LASTACK
         STG   R2,LASTSTS
         ICM   R0,15,ASTATSND
         JZ    SE070
         JAS   R14,SENDSTAT
         LTR   R15,R15
         JZ    SE070
         CLOSE$ 'STATUS FAILED'
         J     SE010
SE070    MSG$
         TXT$  'SMFR020I CONNECTED TO COLLECTOR '
         FLDH$ AHOST,AHOSTL
         TXT$  ':'
         DECF$ APORT
         TXT$  ', RESENDING FROM SEQ '
         LG    R3,SENTL
         AGHI  R3,1
         DECR$ R3
         OUT$  1
*                                         SEND A BATCH
SE100    XC    WAITING,WAITING
         LG    R2,SENTL
         AGHI  R2,1                FIRST
         LG    R3,HEADL            LAST = MIN(HEAD, TAIL+WINDOW,
         LLGF  R4,AWINDOW          FIRST+BATCH-1)
         AG    R4,TAILL
         CLGR  R3,R4
         JNH   *+8
         LGR   R3,R4
         LLGF  R4,ABATCH
         AGR   R4,R2
         AGHI  R4,-1
         CLGR  R3,R4
         JNH   *+8
         LGR   R3,R4
         CLGR  R2,R3
         JH    SE200               NOTHING TO SEND
         STG   R3,LASTB
         JAS   R14,SBATCH
         LTR   R15,R15
         JZ    SE110
         LHI   R0,0
         JAS   R14,CLOSEC
         J     SE010
SE110    LG    R3,LASTB
         CLG   R3,AQSENT
         JNH   *+10
         STG   R3,AQSENT
         MVC   LASTSEND,NOWUS
         MVC   CANSEND,=F'1'
         XC    TIMEOUT,TIMEOUT
         J     SE300
*                                         IDLE: SLEEP UNTIL A DEADLINE
SE200    XC    CANSEND,CANSEND
         LG    R2,NOWUS
         LLGF  R3,AHBEAT
         MSGFI R3,1000000
         AG    R3,LASTSEND         DL = HEARTBEAT
         ICM   R4,15,ASTATSND
         JZ    SE210
         LLGFR R4,R4
         MSGFI R4,1000000
         AG    R4,LASTSTS
         CGR   R4,R3
         JNL   SE210
         LGR   R3,R4
SE210    CLC   SENTL,TAILL
         JE    SE220
         LLGF  R4,AACKTO
         MSGFI R4,1000000
         AG    R4,LASTACK
         CGR   R4,R3
         JNL   SE220
         LGR   R3,R4
SE220    ICM   R4,15,ASTATINT
         JZ    SE230
         LLGFR R4,R4
         MSGFI R4,60000000
         AG    R4,LASTSTAT
         CGR   R4,R3
         JNL   SE230
         LGR   R3,R4
SE230    CLI   ASTOP,0
         JE    SE240
         LG    R4,STOPAT
         CGR   R4,R3
         JNL   SE240
         LGR   R3,R4
SE240    SGR   R3,R2               MICROSECONDS UNTIL THE DEADLINE
         JNM   *+8
         LGHI  R3,0
         CGFI  R3,60000000
         JNH   *+10
         LGFI  R3,60000000
         LGR   R1,R3
         LGHI  R0,0
         DLG   R0,=FD'1000'
         ST    R1,TIMEOUT
*        IDLE HANDSHAKE WITH THE GETTER (COMMIT): SET WAITING, THEN
*        LOOK AT THE HEAD AGAIN - NO WAKE-UP CAN BE LOST
         MVC   AWAITING,=F'1'
         MVC   WAITING,=F'1'
         BCR   15,0
         LG    R2,AQSENT
         CG    R2,AQHEAD
         JNL   SE300               CAUGHT UP: SLEEP
         XC    AWAITING,AWAITING
         XC    WAITING,WAITING
         AGHI  R2,1
         SG    R2,AQTAIL
         CLGF  R2,AWINDOW
         JH    SE300               WINDOW FULL: THE ACK WAKES US
         XC    TIMEOUT,TIMEOUT     NEW WORK ARRIVED
*                                         POLL SOCKET + PIPE
SE300    MVC   PFD0,FD
         MVC   PFD0+4(4),=X'00030000'
         MVC   PFD1,AWAKER
         MVC   PFD1+4(4),=X'00030000'
         CALL  BPX1POL,(PFDPTR,FTWO,TIMEOUT,RV,RC,RSN),VL,MF=(E,CALLPL)
         ICM   R0,15,WAITING
         JZ    SE310
         XC    AWAITING,AWAITING
SE310    L     R0,RV
         LTR   R0,R0
         JNM   SE320
         CLC   RC,=A(EINTR)
         JE    SE320
         CLOSE$ 'POLL FAILED'
         J     SE010
SE320    TM    PFD1+7,X'03'        PIPE: DRAIN THE WAKE-UP BYTES
         JZ    SE330
         LARL  R2,PIPEBUF
         ST    R2,BUFPTRW
         CALL  BPX1RED,(AWAKER,BUFPTRW,FZERO,F64,RV2,RC2,RSN2),VL,     X
               MF=(E,CALLPL)
SE330    TM    PFD0+7,X'63'        SOCKET: IN, HUP, ERR
         JZ    SE400
         LARL  R2,RBUF
         A     R2,RLEN
         ST    R2,BUFPTRW
         LHI   R3,RBUFSZ
         S     R3,RLEN
         ST    R3,WORKF
         CALL  BPX1RED,(FD,BUFPTRW,FZERO,WORKF,RV,RC,RSN),VL,MF=(E,    X
               CALLPL)
         L     R3,RV
         LTR   R3,R3
         JP    SE340
         JZ    SE335
         LHI   R0,0
         JAS   R14,CLOSEC
         J     SE010
SE335    CLOSE$ 'CLOSED BY COLLECTOR'
         J     SE010
SE340    A     R3,RLEN
         ST    R3,RLEN
         JAS   R14,ACKS
         LTR   R15,R15
         JZ    SE400
         CLOSE$ 'PROTOCOL ERROR'
         J     SE010
*                                         STATUS / HEARTBEAT / ACK TMO
SE400    NOW$  R2
         STG   R2,NOWUS
         ICM   R3,15,ASTATSND
         JZ    SE410
         LLGFR R3,R3
         MSGFI R3,1000000
         AG    R3,LASTSTS
         CGR   R2,R3
         JL    SE410
         JAS   R14,SENDSTAT
         LTR   R15,R15
         JZ    SE405
         CLOSE$ 'STATUS FAILED'
         J     SE010
SE405    MVC   LASTSTS,NOWUS
         MVC   LASTSEND,NOWUS
SE410    ICM   R0,15,CANSEND
         JNZ   SE420
         LLGF  R3,AHBEAT
         MSGFI R3,1000000
         AG    R3,LASTSEND
         CG    R3,NOWUS
         JH    SE420
         LHI   R2,PT#HB
         LGHI  R3,0
         LHI   R4,0
         LHI   R5,0
         JAS   R14,SENDFRM
         LTR   R15,R15
         JZ    SE415
         CLOSE$ 'HEARTBEAT FAILED'
         J     SE010
SE415    MVC   LASTSEND,NOWUS
SE420    LG    R2,AQSENT
         CG    R2,AQTAIL
         JNE   SE430
         MVC   LASTACK,NOWUS
         J     SE010
SE430    LLGF  R3,AACKTO
         MSGFI R3,1000000
         AG    R3,LASTACK
         CG    R3,NOWUS
         JH    SE010
         CLOSE$ 'ACK TIMEOUT'
         J     SE010
*                                         END
SEEND    ICM   R0,15,FD
         JM    SE510
         CALL  BPX1CLO,(FD,RV2,RC2,RSN2),VL,MF=(E,CALLPL)
         MVC   FD,=F'-1'
         MVI   ACOLLCON,0
SE510    LG    R2,AQHEAD
         SG    R2,AQTAIL
         JZ    SE520
         MSG$
         TXT$  'SMFR023W '
         DECR$ R2
         TXT$  ' RECORDS NOT ACKNOWLEDGED AT STOP'
         OUT$  1
SE520    L     R13,SAVEA+4
         LM    R14,R12,12(R13)
         SLR   R15,R15
         BR    R14
*
*---------------------------------------------------------------------
* ACKS - PARSE 20-BYTE FRAMES IN RBUF. R15 = 0 OK, 8 PROTOCOL ERROR
*---------------------------------------------------------------------
ACKS     BAKR  R14,0
         LARL  R2,RBUF             R2 = FRAME
         L     R3,RLEN             R3 = BYTES LEFT
AK010    CHI   R3,20
         JL    AK030
         CLC   0(4,R2),MAGIC
         JNE   AK020
         ICM   R0,15,16(R2)        PAYLOAD MUST BE EMPTY
         JNZ   AK020
         CLI   5(R2),PT#ACK
         JNE   AK015
         LG    R4,8(,R2)
         CLG   R4,AQTAIL
         JNH   AK015
         CLG   R4,AQSENT
         JH    AK015
         STG   R4,AQTAIL
         MVC   LASTACK,NOWUS
AK015    LA    R2,20(,R2)
         AHI   R3,-20
         J     AK010
AK020    LHI   R15,8
         PR
AK030    ST    R3,RLEN             KEEP A PARTIAL FRAME
         LTR   R3,R3
         JZ    AK040
         LARL  R4,RBUF
         LR    R5,R3
         LR    R14,R2
         LR    R15,R3
         MVCL  R4,R14
AK040    LHI   R15,0
         PR
*
*---------------------------------------------------------------------
* CONNECT - SOCKET + CONNECT + OPTIONS. R15 = FD OR -1
*---------------------------------------------------------------------
CONNECT  BAKR  R14,0
         CALL  BPX1SOC,(FAINET,FSTREAM,FZERO,FONE,SOCKV,RV,RC,RSN),VL, X
               MF=(E,CALLPL)
         L     R0,RV
         LTR   R0,R0
         JM    CN020
         XC    SADDR,SADDR
         MVI   SADDR,16
         MVI   SADDR+1,2           AF_INET
         MVC   SADDR+2(2),APORT+2
         MVC   SADDR+4(4),AHOSTIP
         CALL  BPX1CON,(SOCKV,F16,SADDR,RV,RC,RSN),VL,MF=(E,CALLPL)
         L     R0,RV
         LTR   R0,R0
         JNM   CN010
         CALL  BPX1CLO,(SOCKV,RV2,RC2,RSN2),VL,MF=(E,CALLPL)
         J     CN020
CN010    CALL  BPX1OPT,(SOCKV,FTWO,FTCP,FONE,F4,FONE,RV2,RC2,RSN2),VL, X
               MF=(E,CALLPL)
         CALL  BPX1OPT,(SOCKV,FTWO,FSOLSOCK,FKEEPAL,F4,FONE,RV2,RC2,   X
               RSN2),VL,MF=(E,CALLPL)
         L     R15,SOCKV
         PR
CN020    LHI   R15,-1
         PR
*
*---------------------------------------------------------------------
* CLOSEC - CLOSE THE COLLECTOR SOCKET. R1/R0 = REASON (R0=0: ERRNO)
*---------------------------------------------------------------------
CLOSEC   BAKR  R14,0
         LR    R2,R1
         LR    R3,R0
         CALL  BPX1CLO,(FD,RV2,RC2,RSN2),VL,MF=(E,CALLPL)
         MVC   FD,=F'-1'
         MVI   ACOLLCON,0
         NOW$  R4
         STG   R4,LASTCLOS
         MSG$
         TXT$  'SMFR021W COLLECTOR CONNECTION CLOSED: '
         LTR   R3,R3
         JZ    CC010
         LR    R1,R2
         LR    R0,R3
         JAS   R14,APPTXT
         J     CC020
CC010    TXT$  'ERRNO='
         DECF$ RC
         TXT$  ' RSN='
         HEX$  RSN,4
CC020    OUT$  1
         PR
*
*---------------------------------------------------------------------
* HELLO - HELLO FRAME + REPLAY OF THE CACHED DICTIONARIES. R15=0 OK
*---------------------------------------------------------------------
HELLO    BAKR  R14,0
         MSG$
         TXT$  'PRODUCT=SMFREAL VERSION=2.0 SYSNAME='
         FLD$  ASYSN,8
         TXT$  ' JOBNAME='
         FLD$  AJOBN,8
         TXT$  ' JOBID='
         JAS   R14,APPJOBID
         TXT$  ' RESOURCE='
         FLDH$ ARES,ARESL
         TXT$  ' INSTANCE='
         HEX$  AINST,8
         LHI   R2,PT#HELLO
         LGHI  R3,0
         LARL  R4,MSGBUF
         L     R5,MSGLEN
         JAS   R14,SENDFRM
         LTR   R15,R15
         JNZ   HE090
*                                         COPY THE DICTIONARIES
         ENQ   (QNAME,RNDICT,E,8,STEP),RET=NONE
         L     R2,ADICTN
         ST    R2,NREPLAY
         LTR   R2,R2
         JZ    HE020
         LA    R3,ADICT
         L     R4,REPLAY
         LA    R5,REPLEN
HE010    L     R1,8(,R3)
         ST    R1,0(,R5)
         LR    R0,R4
         L     R14,12(,R3)
         LR    R15,R1
         MVCL  R0,R14
         AL    R4,=A(MAXREC)
         LA    R3,16(,R3)
         LA    R5,4(,R5)
         JCT   R2,HE010
HE020    DEQ   (QNAME,RNDICT,8,STEP),RET=NONE
         L     R8,NREPLAY
         LTR   R8,R8
         JZ    HE080
         L     R4,REPLAY
         LA    R1,REPLEN
         ST    R1,REPPTR
HE030    L     R1,REPPTR
         L     R5,0(,R1)
         LA    R1,4(,R1)
         ST    R1,REPPTR
         LHI   R2,PT#DICT
         LGHI  R3,0
         JAS   R14,SENDFRM
         LTR   R15,R15
         JNZ   HE090
         AL    R4,=A(MAXREC)
         JCT   R8,HE030
         MSG$
         TXT$  'SMFR022I '
         DECF$ NREPLAY
         TXT$  ' DICTIONARIES REPLAYED'
         OUT$  0
HE080    LHI   R15,0
         PR
HE090    LHI   R15,8
         PR
*
*---------------------------------------------------------------------
* SENDFRM - CONTROL FRAME: R2 TYPE, R3 SEQ (64), R4/R5 DATA/LENGTH
*---------------------------------------------------------------------
SENDFRM  BAKR  R14,0
         LARL  R8,CHDR
         MVC   0(4,R8),MAGIC
         MVI   4(R8),1
         STC   R2,5(,R8)
         XC    6(2,R8),6(R8)
         STG   R3,8(,R8)
         ST    R5,16(,R8)
         LARL  R1,IOV
         ST    R8,0(,R1)
         LHI   R0,20
         ST    R0,4(,R1)
         LHI   R3,1
         LTR   R5,R5
         JZ    SF010
         ST    R4,8(,R1)
         ST    R5,12(,R1)
         LHI   R3,2
SF010    LR    R2,R1
         JAS   R14,WVALL
         LTR   R15,R15
         JNZ   SF020
         LLGFR R0,R5
         AGHI  R0,20
         AG    R0,SSENTB
         STG   R0,SSENTB
SF020    PR
*
*---------------------------------------------------------------------
* SBATCH - RECORDS R2 (FIRST) .. R3 (LAST) IN A SINGLE WRITEV
*---------------------------------------------------------------------
SBATCH   BAKR  R14,0
         LARL  R8,IOV
         LHI   R4,0                COUNT
         LGHI  R5,0                BYTES
SB010    CLGR  R2,R3
         JH    SB020
         LGR   R1,R2
         JAS   R14,SLOTADR
         LA    R0,4(,R15)          HEADER + DATA ARE CONTIGUOUS
         ST    R0,0(,R8)
         L     R0,0(,R15)
         AHI   R0,20
         ST    R0,4(,R8)
         ALGFR R5,R0
         LA    R8,8(,R8)
         AHI   R4,1
         AGHI  R2,1
         J     SB010
SB020    LARL  R2,IOV
         LR    R3,R4
         JAS   R14,WVALL
         LTR   R15,R15
         JNZ   SB030
         LLGFR R0,R4
         AG    R0,SSENTR
         STG   R0,SSENTR
         AG    R5,SSENTB
         STG   R5,SSENTB
         INC$  SBATCHES
         LHI   R15,0
SB030    PR
*
*---------------------------------------------------------------------
* WVALL - WRITEV UNTIL EVERY BYTE IS OUT. R2 = IOV, R3 = COUNT
*---------------------------------------------------------------------
WVALL    BAKR  R14,0
WV010    LTR   R3,R3
         JNP   WV090
         ST    R3,WORKF
         CALL  BPX1WRV,(FD,WORKF,(R2),FZERO,FZERO,RV,RC,RSN),VL,MF=(E, X
               CALLPL)
         L     R4,RV
         LTR   R4,R4
         JNM   WV020
         CLC   RC,=A(EINTR)
         JE    WV010
         LHI   R15,-1
         PR
WV020    LTR   R3,R3               SKIP THE ENTRIES WRITTEN
         JNP   WV090
         CL    R4,4(,R2)
         JL    WV030
         S     R4,4(,R2)
         LA    R2,8(,R2)
         BCTR  R3,0
         J     WV020
WV030    LTR   R4,R4               PARTIAL ENTRY
         JZ    WV010
         L     R0,0(,R2)
         AR    R0,R4
         ST    R0,0(,R2)
         L     R0,4(,R2)
         SR    R0,R4
         ST    R0,4(,R2)
         J     WV010
WV090    LHI   R15,0
         PR
*
*---------------------------------------------------------------------
* SENDSTAT - STATUS FRAME (EBCDIC KEY=VALUE). R15 = 0 OK
*---------------------------------------------------------------------
SENDSTAT BAKR  R14,0
         MSG$
         TXT$  'SMF='
         CLI   ASMFCON,0
         JE    SS010
         TXT$  'CONNECTED'
         J     SS020
SS010    TXT$  'DISCONNECTED'
SS020    TXT$  ' RESOURCE='
         FLDH$ ARES,ARESL
         TXT$  ' GETS='
         DEC$  SGETS
         TXT$  ' SUB1='
         DEC$  SSUB1
         TXT$  ' DICT='
         DEC$  SDICTS
         TXT$  ' PERF='
         DEC$  SPERF
         TXT$  ' OTHER='
         DEC$  SOTHER
         TXT$  ' MISSED='
         DEC$  SMISSED
         TXT$  ' DROPPED='
         DEC$  SDROP
         JAS   R14,APPQUEUE
         TXT$  ' SENT='
         DEC$  SSENTR
         TXT$  ' SENTKB='
         LG    R2,SSENTB
         SRLG  R2,R2,10
         DECR$ R2
         TXT$  ' CONNECTS='
         DEC$  SCONNECT
         TXT$  ' SMFCONNECTS='
         DEC$  SSMFCON
         TXT$  ' SLOTS='
         DECF$ ASLOTS
         TXT$  ' WINDOW='
         DECF$ AWINDOW
         TXT$  ' BATCH='
         DECF$ ABATCH
         TXT$  ' BATCHES='
         DEC$  SBATCHES
         TXT$  ' WAKES='
         DEC$  SWAKES
         TXT$  ' TRACE='
         JAS   R14,APPYN
         TXT$  ' STARTED='
         LA    R1,ASTARTT
         LHI   R0,19
         JAS   R14,APPTXT
         TXT$  ' UPTIME='
         NOW$  R3
         SG    R3,ASTARTUS
         LGR   R1,R3
         LGHI  R0,0
         DLG   R0,=FD'1000000'
         DECR$ R1
         TXT$  ' VERSION=2.0 JOBNAME='
         FLD$  AJOBN,8
         TXT$  ' JOBID='
         JAS   R14,APPJOBID
         TXT$  ' SYSNAME='
         FLD$  ASYSN,8
         LHI   R2,PT#STAT
         LGHI  R3,0
         LARL  R4,MSGBUF
         L     R5,MSGLEN
         JAS   R14,SENDFRM
         PR
*
***********************************************************************
*  SHARED ROUTINES                                                    *
***********************************************************************
*---------------------------------------------------------------------
* SHOWSTAT - SMFR030I-033I. R1 = 1 ALSO ON THE CONSOLE
*---------------------------------------------------------------------
SHOWSTAT BAKR  R14,0
         LR    R8,R1
         MSG$
         TXT$  'SMFR030I SMF '
         FLDH$ ARES,ARESL
         CLI   ASMFCON,0
         JE    ST010
         TXT$  ' CONNECTED'
         J     ST020
ST010    TXT$  ' DISCONNECTED'
ST020    TXT$  ' COLLECTOR '
         FLDH$ AHOST,AHOSTL
         TXT$  ':'
         DECF$ APORT
         CLI   ACOLLCON,0
         JE    ST030
         TXT$  ' CONNECTED'
         J     ST040
ST030    TXT$  ' DISCONNECTED'
ST040    LR    R0,R8
         JAS   R14,LOGOUT
         MSG$
         TXT$  'SMFR031I GETS='
         DEC$  SGETS
         TXT$  ' 110-1='
         DEC$  SSUB1
         TXT$  ' DICT='
         DEC$  SDICTS
         TXT$  ' PERF='
         DEC$  SPERF
         TXT$  ' OTHER='
         DEC$  SOTHER
         TXT$  ' MISSED='
         DEC$  SMISSED
         LR    R0,R8
         JAS   R14,LOGOUT
         MSG$
         TXT$  'SMFR032I'
         JAS   R14,APPQUEUE
         TXT$  ' DROPPED='
         DEC$  SDROP
         TXT$  ' SENT='
         DEC$  SSENTR
         TXT$  ' KB='
         LG    R2,SSENTB
         SRLG  R2,R2,10
         DECR$ R2
         LR    R0,R8
         JAS   R14,LOGOUT
         MSG$
         TXT$  'SMFR033I BATCHES='
         DEC$  SBATCHES
         TXT$  ' (AVG '
         LG    R3,SSENTR
         LG    R4,SBATCHES
         LGHI  R2,0
         LTGR  R4,R4
         JZ    ST050
         DLGR  R2,R4
         J     ST060
ST050    LGHI  R3,0
ST060    DECR$ R3
         TXT$  ' RECORDS) WAKES='
         DEC$  SWAKES
         LR    R0,R8
         JAS   R14,LOGOUT
         PR
*
*---------------------------------------------------------------------
* APPQUEUE - ' QUEUED=n INFLIGHT=n ACKED=n'
*---------------------------------------------------------------------
APPQUEUE BAKR  R14,0
         LG    R2,AQHEAD
         LG    R3,AQSENT
         LG    R4,AQTAIL
         TXT$  ' QUEUED='
         LGR   R5,R2
         SGR   R5,R4
         DECR$ R5
         TXT$  ' INFLIGHT='
         LGR   R5,R3
         SGR   R5,R4
         JNM   *+8
         LGHI  R5,0
         DECR$ R5
         TXT$  ' ACKED='
         DECR$ R4
         PR
*
APPYN    BAKR  R14,0               'Y' OR 'N' FOR THE TRACE FLAG
         CLI   ATRACE,0
         JE    AY010
         TXT$  'Y'
         PR
AY010    TXT$  'N'
         PR
*
APPJOBID BAKR  R14,0               JOB ID OR '-'
         CLI   AJOBID,C' '
         JNH   AJ010
         FLD$  AJOBID,8
         PR
AJ010    TXT$  '-'
         PR
*
*---------------------------------------------------------------------
* IFACALL - CALL THE IFAM SERVICE IN R15 WITH THE 64-BIT PLIST IN R1
*           (AMODE 64, R13 -> F4SA). RETURNS IN AMODE 31
*---------------------------------------------------------------------
IFACALL  BAKR  R14,0
         MVC   IRC,=F'-1'
         MVC   IRSN,=F'-1'
         LLGTR R1,R1
         LLGTR R15,R15
         LARL  R13,F4SA
         LLGTR R13,R13
         SAM64
         BASR  R14,R15
         SAM31
         PR
*
*---------------------------------------------------------------------
* SLOTADR - R1 = SEQUENCE (64). R15 = SLOT ADDRESS
*---------------------------------------------------------------------
SLOTADR  BAKR  R14,0
         LGR   R3,R1
         LGHI  R2,0
         LLGF  R4,ASLOTS
         DLGR  R2,R4               R2 = SEQ MOD SLOTS
         MSFI  R2,SLOTSZ
         A     R2,ARING
         LR    R15,R2
         PR
*
*---------------------------------------------------------------------
* WAKEUP - ONE BYTE INTO THE PIPE (WAKES THE SENDER'S POLL)
*---------------------------------------------------------------------
WAKEUP   BAKR  R14,0
         ICM   R0,15,AWAKEW
         JM    WK010
         CALL  BPX1WRT,(AWAKEW,ONEPTR,FZERO,FONE,RVW,RCW,RSNW),VL,     X
               MF=(E,CALLPL)
WK010    PR
*
*---------------------------------------------------------------------
* NAP - SLEEP R1 SECONDS (1 SECOND STEPS, ENDS EARLY AT STOP)
*---------------------------------------------------------------------
NAP      BAKR  R14,0
         LTR   R3,R1
         JNP   NP020
NP010    CLI   ASTOP,0
         JNE   NP020
         STIMER WAIT,BINTVL=ONESEC
         JCT   R3,NP010
NP020    PR
*
*---------------------------------------------------------------------
* NUMPARSE - R1/R0 = DECIMAL TEXT. R15 = VALUE (64), R0 = 0 OK/8 BAD
*---------------------------------------------------------------------
NUMPARSE BAKR  R14,0
         LTR   R3,R0
         JNP   NU090
         CHI   R3,18
         JH    NU090
         LGHI  R15,0
NU010    LLC   R2,0(,R1)
         CHI   R2,240
         JL    NU090
         CHI   R2,249
         JH    NU090
         AHI   R2,-240
         MGHI  R15,10
         AGFR  R15,R2
         LA    R1,1(,R1)
         JCT   R3,NU010
         LHI   R0,0
         PR
NU090    LHI   R0,8
         PR
*
*---------------------------------------------------------------------
* IPPARSE - R1/R0 = A.B.C.D. R15 = ADDRESS, R0 = 0 OK/8 BAD
*---------------------------------------------------------------------
IPPARSE  BAKR  R14,0
         LTR   R3,R0               R3 = CHARACTERS LEFT
         JNP   IP090
         LR    R2,R1
         LHI   R4,4                OCTETS
         SLR   R15,R15
IP010    SLR   R5,R5               OCTET VALUE
         LHI   R8,0                DIGITS
IP020    LTR   R3,R3
         JNP   IP030
         CLI   0(R2),C'.'
         JE    IP030
         LLC   R1,0(,R2)
         CHI   R1,240
         JL    IP090
         CHI   R1,249
         JH    IP090
         AHI   R1,-240
         MHI   R5,10
         AR    R5,R1
         AHI   R8,1
         LA    R2,1(,R2)
         BCTR  R3,0
         J     IP020
IP030    LTR   R8,R8
         JZ    IP090
         CHI   R5,255
         JH    IP090
         SLL   R15,8
         OR    R15,R5
         BCTR  R4,0
         LTR   R4,R4
         JZ    IP040
         LTR   R3,R3               NEED A DOT AND MORE
         JNP   IP090
         LA    R2,1(,R2)
         BCTR  R3,0
         J     IP010
IP040    LTR   R3,R3               NOTHING AFTER THE 4TH OCTET
         JNZ   IP090
         LHI   R0,0
         PR
IP090    LHI   R0,8
         PR
*
*---------------------------------------------------------------------
* FMTTS - R1 -> 19 BYTES 'YYYY-MM-DD HH:MM:SS' (LOCAL TIME)
*---------------------------------------------------------------------
FMTTS    BAKR  R14,0
         LR    R8,R1
         TIME  DEC,TIMEA,ZONE=LT,LINKAGE=SYSTEM,DATETYPE=YYYYMMDD
         MVC   TSPK(4),TIMEA+8     YYYYMMDD
         MVI   TSPK+4,X'0F'
         UNPK  TSZ(9),TSPK(5)
         MVC   0(4,R8),TSZ
         MVI   4(R8),C'-'
         MVC   5(2,R8),TSZ+4
         MVI   7(R8),C'-'
         MVC   8(2,R8),TSZ+6
         MVI   10(R8),C' '
         MVC   TSPK(3),TIMEA       HHMMSS
         MVI   TSPK+3,X'0F'
         UNPK  TSZ(7),TSPK(4)
         MVC   11(2,R8),TSZ
         MVI   13(R8),C':'
         MVC   14(2,R8),TSZ+2
         MVI   16(R8),C':'
         MVC   17(2,R8),TSZ+4
         PR
*
*---------------------------------------------------------------------
* MESSAGE BUILDER: APPTXT (R1/R0), APPFLD (TRIMMED), APPDEC (R1->D),
* APPDECF (R1->F), APPHEX (R1/R0)
*---------------------------------------------------------------------
APPTXT   BAKR  R14,0
         L     R8,MSGLEN
         LR    R3,R0               LENGTH
         LR    R2,R1               SOURCE
         LHI   R5,MSGMAX
         SR    R5,R8               ROOM
         JNP   AT090
         CR    R3,R5
         JNH   AT010
         LR    R3,R5
AT010    LTR   R3,R3
         JNP   AT090
         LARL  R4,MSGBUF
         AR    R4,R8
         LR    R5,R3
         AR    R8,R3
         ST    R8,MSGLEN
         MVCL  R4,R2
AT090    PR
*
APPFLD   BAKR  R14,0
AF010    LTR   R0,R0
         JNP   AF090
         LR    R3,R1
         AR    R3,R0
         BCTR  R3,0
         CLI   0(R3),C' '
         JE    AF020
         CLI   0(R3),X'00'
         JNE   AF030
AF020    BCTR  R0,0
         J     AF010
AF030    JAS   R14,APPTXT
AF090    PR
*
APPDECF  BAKR  R14,0
         LLGF  R2,0(,R1)
         STG   R2,DECTMP
         LA    R1,DECTMP
         JAS   R14,APPDEC
         PR
*
APPDEC   BAKR  R14,0
         LG    R3,0(,R1)
         LARL  R4,DECBUF+24
         LHI   R5,0
         LGHI  R8,10
AD010    LGHI  R2,0
         DLGR  R2,R8               R3 = QUOTIENT, R2 = DIGIT
         AHI   R2,240
         BCTR  R4,0
         STC   R2,0(,R4)
         AHI   R5,1
         LTGR  R3,R3
         JNZ   AD010
         LR    R1,R4
         LR    R0,R5
         JAS   R14,APPTXT
         PR
*
APPHEX   BAKR  R14,0
         LR    R2,R1
         LTR   R3,R0
         JNP   AH090
AH010    UNPK  HEX3(3),0(2,R2)
         TR    HEX3(2),HEXTAB-240
         LA    R1,HEX3
         LHI   R0,2
         JAS   R14,APPTXT
         LA    R2,1(,R2)
         JCT   R3,AH010
AH090    PR
*
*---------------------------------------------------------------------
* LOGOUT - MSGBUF TO SYSPRINT (TIMESTAMPED) AND, IF R0=1, TO THE
*          CONSOLE (WTO ROUTCDE=2 DESC=6)
*---------------------------------------------------------------------
LOGOUT   BAKR  R14,0
         LR    R8,R0
         LARL  R4,LOGREC
         LA    R1,5(,R4)
         JAS   R14,FMTTS
         MVI   4(R4),C' '
         MVI   24(R4),C' '
         L     R5,MSGLEN
         CHI   R5,230
         JNH   *+8
         LHI   R5,230
         LA    R0,25(,R4)
         LARL  R14,MSGBUF
         LR    R1,R5
         LR    R15,R5
         MVCL  R0,R14
         LA    R5,25(,R5)
         STH   R5,0(,R4)           RDW
         XC    2(2,R4),2(R4)
         ICM   R2,15,APRTDCB
         JZ    LO010
         ENQ   (QNAME,RNLOG,E,8,STEP),RET=NONE
         PUT   (R2),(R4)
         DEQ   (QNAME,RNLOG,8,STEP),RET=NONE
LO010    LTR   R8,R8
         JZ    LO090
         L     R5,MSGLEN
         CHI   R5,125
         JNH   *+8
         LHI   R5,125
         STH   R5,WTOLEN
         LTR   R5,R5
         JNP   LO090
         BCTR  R5,0
         LARL  R14,MSGBUF
         EX    R5,LOMVC
         WTO   TEXT=WTOLEN,ROUTCDE=(2),DESC=(6)
LO090    PR
LOMVC    MVC   WTOTXT(0),0(R14)
*
***********************************************************************
*  STATIC DATA (EVERY TASK HAS ITS OWN COPY OF THE MODULE)            *
***********************************************************************
DATA     LOCTR
         DS    0D
SAVEA    DC    18F'0'
RETC     DC    F'0'
ANCP     DC    A(0)                ANCHOR ADDRESS (MAIN COPY)
ANSWER   DC    A(0)
WORKF    DC    F'0'
LENW     DC    F'0'
CLSW     DC    F'0'
CFGBAD   DC    F'0'
MSGLEN   DC    F'0'
WTOLEN   DC    H'0'
WTOTXT   DC    CL126' '
HOLDLEN  DC    H'0'
         DS    0D
TODW     DC    D'0'
DECTMP   DC    D'0'
ECBL     DC    4A(0)
*                                         Z/OS UNIX SERVICES
RV       DC    F'0'
RC       DC    F'0'
RSN      DC    F'0'
RV2      DC    F'0'
RC2      DC    F'0'
RSN2     DC    F'0'
RVW      DC    F'0'
RCW      DC    F'0'
RSNW     DC    F'0'
         DS    0D
RVD      DC    D'0'
DZERO    DC    FD'0'
FZERO    DC    F'0'
FONE     DC    F'1'
FTWO     DC    F'2'
F4       DC    F'4'
F16      DC    F'16'
F64      DC    F'64'
F255     DC    F'255'
FAINET   DC    F'2'
FSTREAM  DC    F'1'
FTCP     DC    F'6'
FSOLSOCK DC    X'0000FFFF'
FKEEPAL  DC    F'8'
FOPNOPT  DC    X'00000083'         O_CREAT + O_RDWR
FMODE    DC    X'000001B6'         0666
FSETLK   DC    F'6'
FGETLK   DC    F'5'
BUFPTRW  DC    A(0)
ONEPTR   DC    A(ONEBYTE)
ONEBYTE  DC    C'W'
NLCHAR   DC    X'15'
         DS    0D
SIGMASK  DC    XL8'0008000000000000'  SIGPIPE (13)
SIGPTR   DC    A(SIGMASK)
BRLKPTR  DC    A(BRLK)
BRLK     DC    XL24'00'            BPXYBRLK
SOCKV    DC    F'0'
SADDR    DC    XL16'00'
PFDPTR   DC    A(PFD0)
PFD0     DC    F'-1',XL4'00'       POLLFD: SOCKET
PFD1     DC    F'-1',XL4'00'       POLLFD: PIPE
TIMEOUT  DC    F'0'
*                                         IFAM SERVICES (AMODE 64)
         DS    0D
IRC      DC    F'0'
IRSN     DC    F'0'
CNPB     DC    XL106'00'
         DS    0D
GTPB     DC    XL64'00'
DSPB     DC    XL24'00'
         DS    0D
PLCON    DC    AD(CNPB),AD(IRC),AD(IRSN)
PLGET    DC    AD(GTPB),AD(IRC),AD(IRSN)
PLDSC    DC    AD(DSPB),AD(IRC),AD(IRSN)
*                                         GETTER
         DS    0D
NREC     DC    D'0'
LASTMISS DC    D'0'
SLOTP    DC    A(0)
TARGET   DC    A(0)
SCRATCH  DC    A(0)
*                                         SENDER
         DS    0D
NOWUS    DC    D'0'
HEADL    DC    D'0'
SENTL    DC    D'0'
TAILL    DC    D'0'
LASTB    DC    D'0'
LASTSEND DC    D'0'
LASTACK  DC    D'0'
LASTSTAT DC    D'0'
LASTSTS  DC    D'0'
LASTCLOS DC    D'0'
STOPAT   DC    D'0'
FD       DC    F'-1'
RLEN     DC    F'0'
FAILS    DC    F'0'
WAITING  DC    F'0'
CANSEND  DC    F'0'
REPLAY   DC    A(0)
NREPLAY  DC    F'0'
REPPTR   DC    A(0)
REPLEN   DC    (MAXDICT)F'0'
*                                         CONSTANTS
MAGIC    DC    X'534D4652'         'SMFR' IN ASCII
QNAME    DC    CL8'SMFREAL'
RNLOG    DC    CL8'LOG'
RNDICT   DC    CL8'DICT'
CALLPL   DC    12A(0)            PARAMETER LIST (CALL MF=E)
ONESEC   DC    F'100'
HEXTAB   DC    C'0123456789ABCDEF'
HEX3     DC    CL3' '
TIMEA    DC    XL16'00'
TSPK     DC    XL5'00'
TSZ      DC    CL9' '
TSWORK   DC    CL19' '
CMDW     DC    CL64' '
KEYW     DC    CL16' '
LINE     DC    CL72' '
         DC    CL8' '
BLANKS   DC    CL256' '
*                                         CONFIG KEYS
CFGTAB   DS    0H
         DC    AL1(8),CL10'RESOURCE',C'S',AL2(ARESL-ANC),AL2(26)
CFGTABL  EQU   *-CFGTAB
         DC    AL1(4),CL10'HOST',C'S',AL2(AHOSTL-ANC),AL2(64)
         DC    AL1(4),CL10'PORT',C'F',AL2(APORT-ANC),AL2(0)
         DC    AL1(5),CL10'SLOTS',C'F',AL2(ASLOTS-ANC),AL2(0)
         DC    AL1(6),CL10'WINDOW',C'F',AL2(AWINDOW-ANC),AL2(0)
         DC    AL1(5),CL10'BATCH',C'F',AL2(ABATCH-ANC),AL2(0)
         DC    AL1(5),CL10'RETRY',C'F',AL2(ARETRY-ANC),AL2(0)
         DC    AL1(9),CL10'HEARTBEAT',C'F',AL2(AHBEAT-ANC),AL2(0)
         DC    AL1(10),CL10'ACKTIMEOUT',C'F',AL2(AACKTO-ANC),AL2(0)
         DC    AL1(5),CL10'DRAIN',C'F',AL2(ADRAIN-ANC),AL2(0)
         DC    AL1(7),CL10'STATINT',C'F',AL2(ASTATINT-ANC),AL2(0)
         DC    AL1(8),CL10'STATSEND',C'F',AL2(ASTATSND-ANC),AL2(0)
         DC    AL1(5),CL10'TRACE',C'Y',AL2(ATRACE-ANC),AL2(0)
         DC    AL1(7),CL10'MAXRECS',C'D',AL2(AMAXREC-ANC),AL2(0)
         DC    AL1(8),CL10'LOCKFILE',C'S',AL2(ALOCKL-ANC),AL2(255)
         DC    AL1(0)
*                                         DCBS (RMODE 24)
PRTDCB   DCB   DDNAME=SYSPRINT,DSORG=PS,MACRF=PM,RECFM=VB,LRECL=259,   X
               BLKSIZE=3120
CFGDCB   DCB   DDNAME=SMFRCFG,DSORG=PS,MACRF=GM,EODAD=CFGEOF
         LTORG
*
BUF      LOCTR
         DS    0D
F4SA     DS    64D                 SAVE AREA FOR THE AMODE 64 CALLS
MSGBUF   DS    CL(MSGMAX+16)
         DS    0D
DECBUF   DS    CL24
LOGREC   DS    CL260
CFGREC   DS    CL256
HOLDBUF  DS    CL256
PIPEBUF  DS    CL64
         DS    0D
CHDR     DS    XL20
         DS    0D
IOV      DS    (IOVMAX)XL8
         DS    0D
RBUF     DS    CL(RBUFSZ)
*
***********************************************************************
*  ANCHOR - SHARED BY THE THREE TASKS                                 *
***********************************************************************
ANC      DSECT
ASTOP    DS    X                   1 = STOP REQUESTED
ASMFCON  DS    X                   1 = CONNECTED TO THE RESOURCE
ACOLLCON DS    X                   1 = CONNECTED TO THE COLLECTOR
ATRACE   DS    X                   1 = TRACE ON
         DS    0D
AQHEAD   DS    D                   LAST COMMITTED (GETTER)
AQSENT   DS    D                   LAST SENT (SENDER)
AQTAIL   DS    D                   LAST ACKED (SENDER)
AWAITING DS    F                   1 = SENDER IDLE IN POLL
APRTDCB  DS    A                   SYSPRINT DCB (MAIN COPY)
ARING    DS    A
ADICTA   DS    A
ADICTN   DS    F
ADICTX   DS    F
ADICT    DS    (MAXDICT)XL16       APPLID(8) LEN(4) DATA@(4)
AWAKER   DS    F                   PIPE READ END
AWAKEW   DS    F                   PIPE WRITE END
ALOCKFD  DS    F
ASTOPECB DS    F
AGETECB  DS    F
ASNDECB  DS    F
AGETTCB  DS    A
ASNDTCB  DS    A
ATOKEN   DS    XL16
         DS    0D
SGETS    DS    D                   STATISTICS
SSUB1    DS    D
SOTHER   DS    D
SDICTS   DS    D
SPERF    DS    D
SMISSED  DS    D
SDROP    DS    D
SSENTR   DS    D
SSENTB   DS    D
SCONNECT DS    D
SSMFCON  DS    D
SBATCHES DS    D
SWAKES   DS    D
AMAXREC  DS    D                   CONFIGURATION
AHOSTIP  DS    F
APORT    DS    F
ASLOTS   DS    F
AWINDOW  DS    F
ABATCH   DS    F
ARETRY   DS    F
AHBEAT   DS    F
AACKTO   DS    F
ADRAIN   DS    F
ASTATINT DS    F
ASTATSND DS    F
ARESL    DS    H
ARES     DS    CL26
AHOSTL   DS    H
AHOST    DS    CL64
ALOCKL   DS    H
ALOCK    DS    CL256
ASYSN    DS    CL8                 IDENTITY
AJOBN    DS    CL8
AJOBID   DS    CL8
ASTARTT  DS    CL19
         DS    0D
AINST    DS    D
ASTARTUS DS    D
ANCLEN   EQU   *-ANC
*
COM      DSECT
         IEZCOM
CIB      DSECT
         IEZCIB
         DCBD  DSORG=PS,DEVD=DA
         END   SMFREAL

Back to the top of SMFREAL

ISPF and REXX: ZCSVC, a dialog for z/OS Connect

A REXX exec that calls the z/OS Connect REST API, parses the JSON response with the z/OS parser itself and shows the services in an ISPF table. An S next to a service opens all of its fields.

Languages
REXX and the ISPF panel language
Runs on
TSO/E, under ISPF
Services
HTTP enabler (address hwthttp) and JSON parser (address hwtjson) of the z/OS Client Web Enablement Toolkit
API
GET /zosConnect/services and the ServiceURL of each service
Members
ZCSVC (exec, 728 lines), ZCSVCL and ZCSVCD (panels)

How to use it

  • Copy panels ZCSVCL and ZCSVCD to a panel PDS. The exec does a LIBDEF of <your userid>.PANELS; to use a PDS already allocated to ISPPLIB, set panelLib = ''.
  • At the top of the exec, set the host, the port and, for HTTPS, useSSL = 'Y' and the RACF keyRing holding the server's CA.
  • Run it from the ISPF command line: TSO EX 'HLQ.REXX.EXEC(ZCSVC)'. The optional arguments 'host path ssl port' override the values in the exec.
  • On the list, S opens the details (you can mark several), REFRESH calls the API again and END (PF3) exits.

The screens

 --------------------------- z/OS Connect Services ---------------------------- 
 Command ===>                                                 Scroll ===> CSR   
                                                                                
 Server: localhost:50780                  HTTP: 200      Services: 3            
 Type S next to a service to see its details. REFRESH reloads the list.         
                                                                                
 S  Name                           Provider                                     
    Description / URL                                                           
    inquireCatalog                 CICS-1.0                                     
    Lists the catalog items                                                     
    http://localhost:50780/zosConnect/services/inquireCatalog                   
 S  inquireSingle                  CICS-1.0                                     
    Inquires about one catalog item                                             
    http://localhost:50780/zosConnect/services/inquireSingle                    
    placeOrder                     CICS-1.0                                     
    Places an order                                                             
    http://localhost:50780/zosConnect/services/placeOrder                       
******************************* Bottom of data *********************************
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
Panel ZCSVCL as it shows up in the 3270 emulator, with sample data. The red S asks for the details of inquireSingle.
 ------------------------------ Service details ------------------------------- 
 Command ===>                                                 Scroll ===> CSR   
                                                                                
 Service: inquireSingle                                    HTTP: 200            
 URL    : http://localhost:50780/zosConnect/services/inquireSingle              
 Press END to return to the service list.                                       
                                                                                
 Field                            Value                                         
 zosConnect.serviceName           inquireSingle                                 
 zosConnect.serviceDescription    Inquires about one catalog item               
 zosConnect.serviceProvider       CICS-1.0                                      
 zosConnect.serviceURL            http://localhost:50780/zosConnect/services/inq
                                  uireSingle                                    
 zosConnect.serviceInvokeURL      http://localhost:50780/zosConnect/services/inq
                                  uireSingle?action=invoke                      
 zosConnect.serviceStatus         Started                                       
 inquireSingle.connectionRef      cicsConn                                      
 inquireSingle.program            DFH0XCMN                                      
******************************* Bottom of data *********************************
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
Panel ZCSVCD with the fields of the service JSON, also with sample data. Values longer than 46 characters continue on the next line.

How it works

  • In )ATTR, each special character defines a field type. %, + and _ are the defaults (high-intensity text, normal text and input); ? is the line command input and @ ! # $ are outputs, each with its own color.
  • The )MODEL lines repeat for each row of the ISPF table: every service takes three screen lines. .ZVARS gives field Z its real name, ZCSEL, and VER (&ZCSEL,LIST,S) accepts only S.
  • hwtconst creates the HWTH_xxx and HWTJ_xxx constants. Every toolkit call goes through HwtCall or JsonCall, which keep the first error in errMsg so it can be shown on the panel.
  • A connection is hwthinit, hwthset and hwthconn; the GET is a request handle with hwthrqst. The body arrives already converted from ASCII to EBCDIC by the HWTH_XLATE_RESPBODY_A2E option.
  • JsonDump walks the JSON recursively and turns each simple value into a path such as zosConnect.serviceName or list[0].field.
  • The routines that need the toolkit are not PROCEDUREs: the toolkit reads and writes variables by name, in the caller's scope. The ones that are PROCEDUREs expose the list kept in jx.
  • TBDISPL returns one selected row at a time. The exec collects all the selected rows before opening the first detail, because the TBDISPL of the detail panel would discard the pending ones.

ZCSVC, the exec 728 lines

/* REXX ************************************************************/
/*                                                                 */
/* ZCSVC - ISPF dialog for the z/OS Connect services               */
/*                                                                 */
/* Calls GET /zosConnect/services (z/OS Client Web Enablement      */
/* Toolkit - HTTP enabler), parses the response with the z/OS JSON */
/* parser and shows the services in an ISPF table (panel ZCSVCL):  */
/* ServiceName, ServiceDescription, ServiceProvider, ServiceURL.   */
/*                                                                 */
/* With S next to a service, issues a GET on its ServiceURL and    */
/* shows every field of the JSON response (panel ZCSVCD).          */
/* REFRESH command on the list: calls /zosConnect/services again.  */
/*                                                                 */
/* Usage (under ISPF):                                             */
/*   TSO EX 'HLQ.REXX.EXEC(ZCSVC)'                                 */
/*   TSO EX 'HLQ.REXX.EXEC(ZCSVC)' 'host path ssl port'            */
/*      -> overrides the variables below (ssl = Y or N)            */
/*                                                                 */
/* Panels ZCSVCL and ZCSVCD: in the panelLib library (LIBDEF done  */
/* here) or in a library already allocated to ISPPLIB.             */
/*                                                                 */
/* ISPF tables (temporary, NOWRITE):                               */
/*   ZCSVCT - services: ZCNAME ZCDESC ZCPROV ZCURL                 */
/*   ZCSVCF - fields of the selected service: ZCFIELD ZCVALUE      */
/*                                                                 */
/*******************************************************************/
 trace Off

 /*---------------------------------------------------------------*/
 /* Parameters                                                    */
 /*---------------------------------------------------------------*/
 host    = 'localhost'        /* target host                      */
 path    = '/zosConnect/services'
 useSSL  = 'N'                /* Y = HTTPS   N = HTTP             */
 port    = '50780'            /* empty = 80 (HTTP) or 443 (HTTPS) */
 keyRing = ''                 /* RACF keyring for HTTPS, holding  */
                              /* the server's CA. E.g.:           */
                              /* 'MYUSER/MYRING'                  */
 timeout = 30                 /* send/receive timeout (sec)       */
 verbose = 'N'                /* Y = turn on the toolkit trace    */
 panelLib = userid()'.PANELS' /* PDS holding ZCSVCL/ZCSVCD.       */
                              /* '' = panels already in ISPPLIB   */

 /*---------------------------------------------------------------*/
 /* Optional arguments override the variables above               */
 /*---------------------------------------------------------------*/
 parse arg pHost pPath pSSL pPort .
 if pHost <> '' then host   = pHost
 if pPath <> '' then path   = pPath
 if pSSL  <> '' then useSSL = translate(pSSL)
 if pPort <> '' then port   = pPort

 if left(path,1) <> '/' then path = '/'path
 if useSSL = 'Y' then scheme = 'https'
                 else scheme = 'http'
 connUri = scheme'://'host

 if sysvar('SYSISPF') <> 'ACTIVE' then do
    say 'ZCSVC must run under ISPF.'
    exit 12
 end

 /*---------------------------------------------------------------*/
 /* Control and response variables                                */
 /*---------------------------------------------------------------*/
 errMsg          = ''         /* first error of the current step  */
 status          = ''
 HttpStatusCode  = ''
 HttpReasonCode  = ''
 ResponseHeaders. = ''
 ResponseHeaders.0 = 0
 ResponseBody    = ''
 parserHandle    = ''
 Service.        = ''
 Service.0       = 0
 Field.          = ''
 Field.0         = 0

 /*---------------------------------------------------------------*/
 /* Host command environments HWTHTTP/HWTJSON and the toolkit     */
 /* constants HWTH_xxx and HWTJ_xxx                               */
 /*---------------------------------------------------------------*/
 call hwtcalls 'on'

 ReturnCode = -1
 DiagArea.  = ''
 address hwthttp "hwtconst ReturnCode DiagArea."
 if rc <> 0 | ReturnCode <> 0 then do
    say '*** hwtconst failed. REXX RC:' rc 'Toolkit RC:' ReturnCode
    exit 12
 end

 /* Variables seen by the JSON parser PROCEDURE routines          */
 jx = 'parserHandle errMsg Field. HWTJ_OK HWTJ_WARNING',
      'HWTJ_OBJECT_TYPE HWTJ_ARRAY_TYPE HWTJ_STRING_TYPE',
      'HWTJ_NUMBER_TYPE HWTJ_BOOLEAN_TYPE HWTJ_NULL_TYPE HWTJ_TRUE'

 /*---------------------------------------------------------------*/
 /* ISPF: errors return to the exec; panels through LIBDEF        */
 /*---------------------------------------------------------------*/
 address ispexec "CONTROL ERRORS RETURN"
 if panelLib <> '' then do
    address ispexec "LIBDEF ISPPLIB DATASET ID('"panelLib"') STACK"
    if rc <> 0 then do
       say '*** LIBDEF ISPPLIB failed for' panelLib '- RC' rc
       exit 12
    end
 end

 call BuildList
 call ListDialog

 /*---------------------------------------------------------------*/
 /* Cleanup                                                       */
 /*---------------------------------------------------------------*/
 address ispexec "TBEND ZCSVCT"
 call JsonClose
 if panelLib <> '' then address ispexec "LIBDEF ISPPLIB"
 exit 0


/*******************************************************************/
/* BuildList: GET on /zosConnect/services and loads table ZCSVCT   */
/* with the services (ZCNAME ZCDESC ZCPROV ZCURL).                 */
/*******************************************************************/
BuildList:
 address ispexec "TBCREATE ZCSVCT NAMES(ZCNAME ZCDESC ZCPROV ZCURL)",
                 "NOWRITE REPLACE"
 zchost = host
 if port <> '' then zchost = host':'port
 zclstat   = ''
 zcnum     = 0
 Service.0 = 0
 errMsg    = ''

 if CallGet(connUri, port, useSSL, path) then do
    zclstat = status
    if \Http2xx() then
       errMsg = 'GET' path 'returned HTTP' status strip(HttpReasonCode)
    else if ResponseBody = '' then
       errMsg = 'GET' path 'returned an empty body.'
    else if JsonOpen() then do
       call ListServices
       call JsonClose
    end
 end

 do k = 1 to Service.0
    zcname = Service.k.Name
    zcdesc = Service.k.Desc
    zcprov = Service.k.Provider
    zcurl  = Service.k.URL
    address ispexec "TBADD ZCSVCT"
 end
 zcnum = Service.0
 address ispexec "TBTOP ZCSVCT"

 if errMsg <> '' then call ShowMsg 'List error', errMsg
 return


/*******************************************************************/
/* ListDialog: shows table ZCSVCT until the user presses END.      */
/* Line command S = service details (several may be selected).     */
/*******************************************************************/
ListDialog:
 listTop = 0
 do forever
    zcmd  = ''
    zcsel = ''
    address ispexec "TBTOP ZCSVCT"
    if listTop > 0 then
       address ispexec "TBSKIP ZCSVCT NUMBER("listTop")"
    address ispexec "TBDISPL ZCSVCT PANEL(ZCSVCL)"
    if rc > 4 then leave                     /* END / RETURN        */
    listTop = ztdtop

    /* Collect the selected rows before showing the details:      */
    /* the detail panel's TBDISPL would drop the pending ones.    */
    sel.0 = 0
    do forever
       if zcsel = 'S' then do
          n = sel.0 + 1
          sel.0 = n
          sel.n.1 = zcname
          sel.n.2 = zcurl
       end
       if ztdsels <= 1 then leave
       zcsel = ''
       address ispexec "TBDISPL ZCSVCT"      /* next selected row   */
       if rc > 4 then leave
    end

    zcmd = strip(zcmd)
    if zcmd = 'REFRESH' | zcmd = 'R' then do
       call BuildList
       listTop = 0
       iterate
    end
    if zcmd <> '' then
       call ShowMsg 'Invalid command', 'Command' zcmd 'is not valid.',
                     'Use REFRESH or the S line command.'

    do n = 1 to sel.0
       call ShowDetail sel.n.1, sel.n.2
    end
 end
 return


/*******************************************************************/
/* ShowDetail: GET on the ServiceURL arg(2) of service arg(1) and  */
/* shows every field of the JSON response in table ZCSVCF.         */
/*******************************************************************/
ShowDetail:
 parse arg zcname, zcurl
 errMsg       = ''
 zcdstat      = ''
 ResponseBody = ''
 Field.0      = 0

 if \SplitUrl(zcurl) then
    errMsg = 'Unsupported ServiceURL:' zcurl
 else if CallGet(uScheme'://'uHost, uPort, uSSL, uPath) then do
    zcdstat = status
    if \Http2xx() then
       errMsg = 'GET returned HTTP' status strip(HttpReasonCode)
    if Http2xx() & ResponseBody <> '' then
       if JsonOpen() then do
          /* After HWTJPARS, the handle of the JSON root is 0     */
          call JsonDump 0, ''
          call JsonClose
       end
 end

 /* No JSON fields (HTTP error or invalid body): body as text     */
 if Field.0 = 0 & ResponseBody <> '' then call BodyAsFields

 /*--- Table ZCSVCF: long values continue on the next row --------*/
 address ispexec "TBCREATE ZCSVCF NAMES(ZCFIELD ZCVALUE)",
                 "NOWRITE REPLACE"
 do i = 1 to Field.0
    @c = Field.i.1
    @v = Field.i.2
    do until @c = '' & @v = ''
       zcfield = left(@c, min(length(@c), 32))
       zcvalue = left(@v, min(length(@v), 46))
       @c = substr(@c, length(zcfield) + 1)
       @v = substr(@v, length(zcvalue) + 1)
       address ispexec "TBADD ZCSVCF"
    end
 end

 if errMsg <> '' then call ShowMsg 'Service error', errMsg

 dtTop = 0
 do forever
    zcmd = ''
    address ispexec "TBTOP ZCSVCF"
    if dtTop > 0 then
       address ispexec "TBSKIP ZCSVCF NUMBER("dtTop")"
    address ispexec "TBDISPL ZCSVCF PANEL(ZCSVCD)"
    if rc > 4 then leave                     /* END / RETURN        */
    dtTop = ztdtop
 end
 address ispexec "TBEND ZCSVCF"
 return


/*******************************************************************/
/* BodyAsFields: puts the lines of the body in Field. (field       */
/* '(body)' on the first line) when there are no JSON fields.      */
/*******************************************************************/
BodyAsFields:
 @body = translate(ResponseBody, '25'x, '15'x)    /* NL -> LF      */
 @name = '(body)'
 do while @body <> ''
    parse var @body @line '25'x @body
    call AddField @name, strip(@line, 'T', '0D'x)
    @name = ''
 end
 return


/*******************************************************************/
/* ShowMsg: shows a message on the next panel (ISRZ001).           */
/*   arg(1) = short message (up to 24)   arg(2) = long message     */
/*******************************************************************/
ShowMsg:
 parse arg zedsmsg, zedlmsg
 zedsmsg = left(zedsmsg, min(length(zedsmsg), 24))
 address ispexec "SETMSG MSG(ISRZ001)"
 return


/*******************************************************************/
/* CallGet: connects, issues the GET of arg(4) and disconnects.    */
/*   arg(1) = server URI   arg(2) = port   arg(3) = Y/N SSL        */
/* Returns 1 if the request was made (status in "status").         */
/*******************************************************************/
CallGet:
 parse arg chUri, chPort, chSSL, chPath
 status = ''
 chConn = Connect(chUri, chPort, chSSL)
 if chConn = '' then return 0
 chOk = DoGet(chConn, chPath)
 call Disconnect chConn
 if chOk then status = strip(HttpStatusCode, 'L', '0')
 return chOk


/*******************************************************************/
/* Http2xx: 1 if the last HTTP status is 2xx.                      */
/*******************************************************************/
Http2xx:
 return (datatype(status, 'W') & status >= 200 & status <= 299)


/*******************************************************************/
/* SplitUrl: splits an absolute URL into uScheme, uSSL ('Y'/'N'),  */
/* uHost, uPort ('' when not given) and uPath.                     */
/* Returns 1 if OK, 0 if the URL is not http(s)://host[:p]/...     */
/*******************************************************************/
SplitUrl:
 parse arg @url
 parse var @url uScheme '://' @rest
 uScheme = translate(uScheme, 'abcdefghijklmnopqrstuvwxyz',,
                              'ABCDEFGHIJKLMNOPQRSTUVWXYZ')
 if uScheme = 'https' then uSSL = 'Y'
 else if uScheme = 'http' then uSSL = 'N'
 else return 0
 parse var @rest @hostPort '/' uPath
 uPath = '/'uPath
 parse var @hostPort uHost ':' uPort
 if uHost = '' then return 0
 return 1


/*******************************************************************/
/* Connect: creates and connects a connection handle.              */
/*   arg(1) = server URI (http[s]://host)                          */
/*   arg(2) = port ('' = protocol default)                         */
/*   arg(3) = Y for HTTPS                                          */
/* Returns the handle, or '' on error (handle already freed).      */
/*******************************************************************/
Connect:
 parse arg cnUri, cnPort, cnSSL
 cnH = ''
 handleType = HWTH_HANDLETYPE_CONNECTION
 if \HwtCall('hwthinit', 'ReturnCode handleType cnH DiagArea.') then
    return ''

 cnOk = 0
 do 1
    if verbose = 'Y' then
       if \HwtCall('hwthset', 'ReturnCode cnH HWTH_OPT_VERBOSE',
                              'HWTH_VERBOSE_ON DiagArea.') then leave

    if \HwtCall('hwthset', 'ReturnCode cnH HWTH_OPT_URI',
                           'cnUri DiagArea.') then leave

    if cnPort <> '' then
       if \HwtCall('hwthset', 'ReturnCode cnH HWTH_OPT_PORT',
                              'cnPort DiagArea.') then leave

    if \HwtCall('hwthset', 'ReturnCode cnH',
                           'HWTH_OPT_SNDTIMEOUTVAL timeout',
                           'DiagArea.') then leave
    if \HwtCall('hwthset', 'ReturnCode cnH',
                           'HWTH_OPT_RCVTIMEOUTVAL timeout',
                           'DiagArea.') then leave

    if \HwtCall('hwthset', 'ReturnCode cnH HWTH_OPT_COOKIETYPE',
                           'HWTH_COOKIETYPE_SESSION',
                           'DiagArea.') then leave

    if cnSSL = 'Y' then do
       if \HwtCall('hwthset', 'ReturnCode cnH HWTH_OPT_USE_SSL',
                              'HWTH_SSL_USE DiagArea.') then leave
       if keyRing <> '' then do
          if \HwtCall('hwthset', 'ReturnCode cnH',
                                 'HWTH_OPT_SSLKEYTYPE',
                                 'HWTH_SSLKEYTYPE_KEYRINGNAME',
                                 'DiagArea.') then leave
          if \HwtCall('hwthset', 'ReturnCode cnH',
                                 'HWTH_OPT_SSLKEY keyRing',
                                 'DiagArea.') then leave
       end
    end

    if \HwtCall('hwthconn', 'ReturnCode cnH DiagArea.') then leave
    cnOk = 1
 end

 if cnOk then return cnH
 call HwtCall 'hwthterm', 'ReturnCode cnH HWTH_NOFORCE DiagArea.'
 return ''


/*******************************************************************/
/* Disconnect: disconnects and frees connection handle arg(1).     */
/*******************************************************************/
Disconnect:
 parse arg dcH
 call HwtCall 'hwthdisc', 'ReturnCode dcH DiagArea.'
 call HwtCall 'hwthterm', 'ReturnCode dcH HWTH_NOFORCE DiagArea.'
 return


/*******************************************************************/
/* DoGet: sends a GET of arg(2) (path) on connection arg(1).       */
/* Fills HttpStatusCode, HttpReasonCode, ResponseHeaders. and      */
/* ResponseBody. The request handle is created and freed here.     */
/* Returns 1 if the request was made, 0 on error.                  */
/*******************************************************************/
DoGet:
 parse arg fgConn, fgPath
 HttpStatusCode    = ''
 HttpReasonCode    = ''
 ResponseHeaders.  = ''
 ResponseHeaders.0 = 0
 ResponseBody      = ''

 fgReq = ''
 handleType = HWTH_HANDLETYPE_HTTPREQUEST
 if \HwtCall('hwthinit', 'ReturnCode handleType fgReq',
                         'DiagArea.') then return 0

 fgOk = 0
 do 1
    if \HwtCall('hwthset', 'ReturnCode fgReq',
                           'HWTH_OPT_REQUESTMETHOD',
                           'HWTH_HTTP_REQUEST_GET DiagArea.') then leave

    if \HwtCall('hwthset', 'ReturnCode fgReq HWTH_OPT_URI',
                           'fgPath DiagArea.') then leave

    if \HwtCall('hwthset', 'ReturnCode fgReq',
                           'HWTH_OPT_RESPONSEHDR_USERDATA',
                           'ResponseHeaders. DiagArea.') then leave

    /* Converts the received body from ASCII to EBCDIC (IBM-1047) */
    if \HwtCall('hwthset', 'ReturnCode fgReq',
                           'HWTH_OPT_TRANSLATE_RESPBODY',
                           'HWTH_XLATE_RESPBODY_A2E',
                           'DiagArea.') then leave

    if \HwtCall('hwthset', 'ReturnCode fgReq',
                           'HWTH_OPT_RESPONSEBODY_USERDATA',
                           'ResponseBody DiagArea.') then leave

    if \HwtCall('hwthrqst', 'ReturnCode fgConn fgReq',
                            'HttpStatusCode HttpReasonCode',
                            'DiagArea.') then leave
    fgOk = 1
 end

 call HwtCall 'hwthterm', 'ReturnCode fgReq HWTH_NOFORCE DiagArea.'
 return fgOk


/*******************************************************************/
/* JsonOpen: creates the parser and parses ResponseBody.           */
/* Returns 1 if OK, 0 on error (the parser is already freed).      */
/*******************************************************************/
JsonOpen:
 if \JsonCall('hwtjinit', 'ReturnCode parserHandle DiagArea.') then
    return 0
 if JsonCall('hwtjpars', 'ReturnCode parserHandle ResponseBody',
                         'DiagArea.') then return 1
 errMsg = errMsg '- Start of body (hex):' c2x(left(ResponseBody, 16))
 call JsonClose
 return 0


/*******************************************************************/
/* JsonClose: frees the parser, if there is one.                   */
/*******************************************************************/
JsonClose:
 if parserHandle <> '' then
    call JsonCall 'hwtjterm', 'ReturnCode parserHandle DiagArea.'
 parserHandle = ''
 return


/*******************************************************************/
/* ListServices: reads the zosConnectServices array of the root    */
/* and keeps each service in the Service. stem.                    */
/*   Service.0          = number of services                       */
/*   Service.i.Name     = ServiceName                              */
/*   Service.i.Desc     = ServiceDescription                       */
/*   Service.i.Provider = ServiceProvider                          */
/*   Service.i.URL      = ServiceURL                               */
/*******************************************************************/
ListServices:
 Service.0 = 0
 if JsonType(0) <> HWTJ_OBJECT_TYPE then do
    if errMsg = '' then errMsg = 'The JSON root is not an object.'
    return
 end
 svcArr = JsonMember(0, 'zosConnectServices')
 if svcArr = '' then do
    if errMsg = '' then
       errMsg = 'Field zosConnectServices not found.'
    return
 end
 if JsonType(svcArr) <> HWTJ_ARRAY_TYPE then do
    if errMsg = '' then errMsg = 'zosConnectServices is not an array.'
    return
 end

 svcCount = JsonCount(svcArr)
 do svcIdx = 0 to svcCount - 1
    svcH = ''
    if \JsonCall('hwtjgaen', 'ReturnCode parserHandle svcArr',
                             'svcIdx svcH DiagArea.') then return
    if JsonType(svcH) <> HWTJ_OBJECT_TYPE then iterate
    k = Service.0 + 1
    Service.0          = k
    Service.k.Name     = JsonField(svcH, 'ServiceName')
    Service.k.Desc     = JsonField(svcH, 'ServiceDescription')
    Service.k.Provider = JsonField(svcH, 'ServiceProvider')
    Service.k.URL      = JsonField(svcH, 'ServiceURL')
 end
 return


/*******************************************************************/
/* JsonDump: walks the value of handle arg(1) recursively and      */
/* keeps each simple value in Field. (path, value).                */
/*   arg(2) = path to the handle (e.g. placeOrder.ServiceURL)      */
/* Returns 1 if OK, 0 on error.                                    */
/*******************************************************************/
JsonDump: procedure expose (jx)
 parse arg h, path
 typ = JsonType(h)
 if typ = '' then return 0

 if typ <> HWTJ_OBJECT_TYPE & typ <> HWTJ_ARRAY_TYPE then do
    if path = '' then path = '(root)'
    call AddField path, JsonValue(h, typ)
    return 1
 end

 n = JsonCount(h)
 if n = '' then return 0
 if n = 0 then do
    if path = '' then path = '(root)'
    if typ = HWTJ_OBJECT_TYPE then call AddField path, '{}'
                              else call AddField path, '[]'
    return 1
 end

 do i = 0 to n - 1
    name = ''
    valH = ''
    if typ = HWTJ_OBJECT_TYPE then do
       if \JsonCall('hwtjgoen', 'ReturnCode parserHandle h i name',
                                'valH DiagArea.') then return 0
       if path = '' then child = name
                    else child = path'.'name
    end
    else do
       if \JsonCall('hwtjgaen', 'ReturnCode parserHandle h i valH',
                                'DiagArea.') then return 0
       child = path'['i']'
    end
    if \JsonDump(valH, child) then return 0
 end
 return 1


/*******************************************************************/
/* AddField: appends (path arg(1), value arg(2)) to Field.         */
/*   Field.0 = count   Field.i.1 = path   Field.i.2 = value        */
/* Not a PROCEDURE: uses the Field. stem visible to the caller.    */
/*******************************************************************/
AddField:
 parse arg @c, @v
 @n = Field.0 + 1
 Field.0    = @n
 Field.@n.1 = @c
 Field.@n.2 = @v
 return


/*******************************************************************/
/* JsonType: type of the handle value (HWTJ_xxx_TYPE), '' if error.*/
/* In REXX, hwtjgjst returns the NAME of the type (e.g.            */
/* 'HWTJ_OBJECT_TYPE'), which is turned into the constant's value. */
/*******************************************************************/
JsonType: procedure expose (jx)
 parse arg h
 typ = ''
 if \JsonCall('hwtjgjst', 'ReturnCode parserHandle h typ',
                          'DiagArea.') then return ''
 typ = strip(typ)
 select
    when typ == 'HWTJ_OBJECT_TYPE'  then return HWTJ_OBJECT_TYPE
    when typ == 'HWTJ_ARRAY_TYPE'   then return HWTJ_ARRAY_TYPE
    when typ == 'HWTJ_STRING_TYPE'  then return HWTJ_STRING_TYPE
    when typ == 'HWTJ_NUMBER_TYPE'  then return HWTJ_NUMBER_TYPE
    when typ == 'HWTJ_BOOLEAN_TYPE' then return HWTJ_BOOLEAN_TYPE
    when typ == 'HWTJ_NULL_TYPE'    then return HWTJ_NULL_TYPE
    otherwise return typ
 end


/*******************************************************************/
/* JsonCount: number of entries of an object/array, '' on error.   */
/*******************************************************************/
JsonCount: procedure expose (jx)
 parse arg h
 n = ''
 if \JsonCall('hwtjgnue', 'ReturnCode parserHandle h n',
                          'DiagArea.') then return ''
 return n


/*******************************************************************/
/* JsonMember: handle of field arg(2) of object arg(1), '' if it   */
/* does not exist.                                                 */
/*******************************************************************/
JsonMember: procedure expose (jx)
 parse arg h, target
 n = JsonCount(h)
 if n = '' then return ''
 do i = 0 to n - 1
    name = ''
    valH = ''
    if \JsonCall('hwtjgoen', 'ReturnCode parserHandle h i name',
                             'valH DiagArea.') then return ''
    if name == target then return valH
 end
 return ''


/*******************************************************************/
/* JsonField: value (as text) of field arg(2) of object arg(1).    */
/* Returns '' if the field does not exist.                         */
/*******************************************************************/
JsonField: procedure expose (jx)
 parse arg h, target
 valH = JsonMember(h, target)
 if valH = '' then return ''
 return JsonValue(valH, JsonType(valH))


/*******************************************************************/
/* JsonValue: simple value of handle arg(1), of type arg(2), as    */
/* text (unquoted string, number, true, false, null).              */
/*******************************************************************/
JsonValue: procedure expose (jx)
 parse arg h, typ
 v = ''
 select
    when typ = HWTJ_STRING_TYPE | typ = HWTJ_NUMBER_TYPE then do
       if \JsonCall('hwtjgval', 'ReturnCode parserHandle h v',
                                'DiagArea.') then return '?'
       return v
    end
    when typ = HWTJ_BOOLEAN_TYPE then do
       if \JsonCall('hwtjgbov', 'ReturnCode parserHandle h v',
                                'DiagArea.') then return '?'
       v = strip(v)
       if v == 'HWTJ_TRUE' | v = HWTJ_TRUE then return 'true'
       return 'false'
    end
    when typ = HWTJ_NULL_TYPE then return 'null'
    otherwise return '?'
 end


/*******************************************************************/
/* HwtCall: runs a toolkit service through ADDRESS HWTHTTP.        */
/*   arg(1) = service (hwthinit, hwthset, ...)                     */
/*   arg(2) = names of the variables passed to the service         */
/* Returns 1 if OK (RC <= HWTH_WARNING), 0 on error. The first     */
/* error is kept in errMsg, to be shown on the panel.              */
/* Not a PROCEDURE: the toolkit must see the variables.            */
/*******************************************************************/
HwtCall:
 parse arg @fn, @parms
 ReturnCode = -1
 DiagArea.  = ''
 address hwthttp @fn @parms
 @rexxRc = rc
 if @rexxRc = 0 & ReturnCode <= HWTH_WARNING then return 1

 if errMsg = '' then do
    if @rexxRc <> 0 then
       errMsg = @fn '(' || word(@parms, 3) || ') REXX RC' @rexxRc
    else
       errMsg = @fn '(' || word(@parms, 3) || ') RC' ReturnCode,
                "(X'" || d2x(abs(ReturnCode)) || "')",
                'Reason' DiagArea.HWTH_ReasonCode || ':',
                strip(DiagArea.HWTH_ReasonDesc, , '00'x)
 end
 return 0


/*******************************************************************/
/* JsonCall: runs a JSON parser service through ADDRESS HWTJSON.   */
/*   arg(1) = service (hwtjinit, hwtjpars, ...)                    */
/*   arg(2) = names of the variables passed to the service         */
/* Returns 1 if OK (RC <= HWTJ_WARNING), 0 on error. The first     */
/* error is kept in errMsg, to be shown on the panel.              */
/* Not a PROCEDURE: it runs in the caller's scope, so the parser   */
/* can see the variables.                                          */
/*******************************************************************/
JsonCall:
 parse arg @fn, @parms
 ReturnCode = -1
 DiagArea.  = ''
 address hwtjson @fn @parms
 @rexxRc = rc
 if @rexxRc = 0 & ReturnCode <= HWTJ_WARNING then return 1

 if errMsg = '' then do
    if @rexxRc <> 0 then
       errMsg = @fn 'REXX RC' @rexxRc
    else
       errMsg = @fn 'RC' ReturnCode,
                "(X'" || d2x(abs(ReturnCode)) || "')",
                'Reason' DiagArea.ReasonCode || ':',
                strip(DiagArea.ReasonDesc, , '00'x)
 end
 return 0

ZCSVCL, the service list 29 lines

)ATTR DEFAULT(%+_)
/*-------------------------------------------------------------------*/
/* ZCSVCL - List of the z/OS Connect services (exec ZCSVC)           */
/*-------------------------------------------------------------------*/
 ? TYPE(INPUT)  INTENS(HIGH) CAPS(ON)  JUST(LEFT) COLOR(RED)
 @ TYPE(OUTPUT) INTENS(HIGH) CAPS(OFF) JUST(LEFT) COLOR(YELLOW)
 ! TYPE(OUTPUT) INTENS(LOW)  CAPS(OFF) JUST(LEFT) COLOR(WHITE)
 # TYPE(OUTPUT) INTENS(LOW)  CAPS(OFF) JUST(LEFT) COLOR(TURQ)
 $ TYPE(OUTPUT) INTENS(LOW)  CAPS(OFF) JUST(LEFT) COLOR(GREEN)
)BODY
%--------------------------- z/OS Connect Services ----------------------------
%Command ===>_ZCMD                                           %Scroll ===>_AMT +
+
+Server:!ZCHOST                          +HTTP:!ZCLSTAT+ Services:!ZCNUM+
+Type%S+next to a service to see its details.%REFRESH+reloads the list.
+
%S  Name                           Provider
%   Description / URL
)MODEL
?Z+@ZCNAME                        !ZCPROV
+  #ZCDESC
+  $ZCURL
)INIT
 .ZVARS = '(ZCSEL)'
 IF (&AMT = &Z)
    &AMT = CSR
)PROC
 VER (&ZCSEL,LIST,S)
)END

ZCSVCD, the details of a service 23 lines

)ATTR DEFAULT(%+_)
/*-------------------------------------------------------------------*/
/* ZCSVCD - Fields of a z/OS Connect service (exec ZCSVC)            */
/*-------------------------------------------------------------------*/
 @ TYPE(OUTPUT) INTENS(HIGH) CAPS(OFF) JUST(LEFT) COLOR(YELLOW)
 ! TYPE(OUTPUT) INTENS(LOW)  CAPS(OFF) JUST(LEFT) COLOR(WHITE)
 # TYPE(OUTPUT) INTENS(LOW)  CAPS(OFF) JUST(LEFT) COLOR(TURQ)
 $ TYPE(OUTPUT) INTENS(LOW)  CAPS(OFF) JUST(LEFT) COLOR(GREEN)
)BODY
%------------------------------ Service details -------------------------------
%Command ===>_ZCMD                                           %Scroll ===>_AMT +
+
+Service:@ZCNAME                                          +HTTP:!ZCDSTAT+
+URL    :$ZCURL
+Press%END+to return to the service list.
+
%Field                            Value
)MODEL
!ZCFIELD                         #ZCVALUE
)INIT
 IF (&AMT = &Z)
    &AMT = CSR
)END

About MainframeGo

MainframeGo is an open mainframe study notebook. The idea is simple: learn, test and share what worked.

The examples are starting points. Dataset names, DD names and conventions change from one installation to another, so adapt and test them before use. The code sticks to plain characters on purpose, so it does not depend on your emulator's code page.

An independent project, not affiliated with IBM or any other vendor.