Virtual 1403

How to Use Virtual1403

← Return Home

You can either host your own Virtual1403 Server or use this very server you are connected to now.

Running your own server entails several steps such as obtaining https certificates, obtaining a 1403 font license (or using another font of your choosing), and having your own web accessible server.

Using the hosted version of Virtual1403

Setup steps to send your mainframe listings to Virtual1403

  1. Obtain the virtual1403 agent binary for your environment (Linux, macOS, or Windows). Or compile from source.
  2. Obtain the ready-made config.yaml file with your personal API key from your user page on this website.
  3. Put the config.yaml with your personal - and secret - API key in the directory of the virtual1403 agent binary.
  4. Inside Hercules (or Hyperion) turn your 1403 printer into a socket printer (see screen shot below).
  5. Start the virtual1403 agent and check if it connected to Hercules.
  6. If needed, (re)start the printer in JES with $SPRT1.
  7. Submit your jobs with MSGCLASS=A and check your inbox for the listing.

Configuring TK4- MVS 3.8

On the Hercules/Hyperion console

Enter the following Hercules command (this is not an MVS or JES command!):

devinit 00E localhost:1403 sockdev

Hercules console showing devinit command

In your operating system shell

Start virtual1403 and let it connect to the 1403 socket interface you just activated on Hercules.

Command window showing virtual1403 agent starting

You may need to restart your JES2 printer

Start the printer in JES with the command $SPRT1 on the MVS console.

Some (later) version of MVS may require you to enter this command twice (to confirm the printer form.)

Hercules console showing the command '/$SPRT1'

Now you can submit jobs for printing and have them emailed to you

Make sure to use MSGCLASS=A on your JOB card to print to Virtual1403.

JCL job card showing MSGCLASS=A

Disable Recurring MF/1 Output

TK4- has MF/1 set up (a performance monitoring tool, the predecessor of RMF on z/OS), which prints at regular intervals to MSGCLASS=A.

We don't want that because you will get all those jobs emailed to you! Let's disable it with the MVS console command P MF1

Hercules console showing the command '/P MF1' entered

Configuring VM/370

Getting your VM/370 listings emailed to you is very easy! Here are the steps:

  1. Obtain the virtual1403 agent binary for your environment (Linux, macOS, or Windows). Or compile from source.
  2. Obtain the ready-made config.yaml file with your personal API key from your user page on this website.
  3. Put the config.yaml with your personal - and secret - API key in the directory of the virtual1403 agent binary.
  4. Inside Hercules (or Hyperion) turn your 1403 printer into a socket printer (see screen shot above).
  5. Start the virtual1403 agent and check if it connected to Hercules.
  6. Start the line printer in your VM/370 Operator console with START ALL.
  7. As a CMS user print your filew with: spool print system and then print to VIRTUAL1403 with: print hello listing a

Other operating systems

Other versions of mainframe operating systems work much the same way. VSE should work out of the box, as well as MTS and MUSIC/SP. We have also tried later version of MVS and VM. They all just work

User Limits

Users are allowed 15 jobs and 800 pages during the previous 24 hours. Accounts without a print job in the previous 2 months will be deleted. Once you go over your quota a warning will show up on your user page.