Skip to content

Latest commit

 

History

History
62 lines (39 loc) · 2.03 KB

README.md

File metadata and controls

62 lines (39 loc) · 2.03 KB
Raw

MXE

Sample z/OS synchronous cross memory server written in HLASM

Strongly suggest installing on a test system only.

Install

Allocate the PDS data sets for ASM, MACLIB, SAMPLIB

Clone the repository

If you have git installed on z/OS simply clone the repository from a command shell.

Using SSH

git clone [email protected]:rscott-rocket/mxe.git

Using HTTPS

git clone https://github.com/rscott-rocket/mxe.git

Install from a zip file

If you don't have git installed on z/OS download a zip file from Github and use the following instructions.

  1. FTP the zip file to z/OS as a binary file

  2. Extract the zip file jar xf mxe-master.zip

  3. The files will be in ASCII (ISO8859-1) encoding so the files need to be tagged.

    • cd mxe-master
    • chtag -R -tc ISO8859-1 .

Copy the z/OS Unix files to PDS data sets

Copy the files from the file system converting ISO8859-1 to EBCDIC (if required) -O u. File extensions will be stripped using the -A flag.

Ensure you have set the _BPXK_AUTOCVT=ON environment variable.

   cp -A -O u asm/* "//'HLQ.MXE.ASM'"
   cp -A -O u samplib/* "//'HLQ.MXE.SAMPLIB'"
   cp -A -O u maclib/* "//'HLQ.MXE.MACLIB'"

Post installation

  • Edit the MXEALLOC member of the samplib directory to z/OS system and submit the JCL.
  • Edit and submit the MXEBUILD JCL in SAMPLIB to assemble and linkedit the product.
  • Update your runtime PARMLIB PROGxx member with the contents of MXEPROG in the SAMPLIB dataset.
  • Update your rutiime PARMLIB SCHEDxx member with the contents of MXESCHED in the SAMPLIB dataset.
  • Copy the contents of MXE in the SAMPLIB dataset to your system PROCLIB dataset.
  • Assign a userid to the MXE started task and ensure it has read access to the SMXELOAD dataset.
  • Issue the S MXE operator command to start the server.

MXE can be stopped using the P MXE operator command.

Running from TSO

Make the SMXELOAD dataset available to your TSO userid load module search order.

Issue the MXETSO command from ISPF option 6 or the READY prompt.