Retro1.org codex

User Tools

Site Tools

Trace: • System Parameter Descriptions
ibm:hercules:userref:system.parameters

Table of Contents

System Parameter Descriptions

Device Definition Descriptions

Local non-SNA 3270 Devices

General Format 

  devaddr devtype [{groupname | *} [ipaddr [mask]]]

Integrated 3270 (SYSG) Console

General Format 

  devaddr SYSG [{groupname | *} [ipaddr[mask]]]

Console Printer-Keyboard Devices

General Format 

  devaddr devtype [NOPROMPT]
  [{groupname | *} [ipaddr [mask]]]

Line Printer Devices

General Format 

  devaddr devtype filename [CRLF] [NOCLEAR] [RAWCC] 
      [FCBCHECK | NOFCBCHECK]
      [OPTBROWSE | OPTPRINT]
      [LPI={6 | lpi]
      [INDEX={0 | idx]
      [LPP={66 | lpp}]
      [FCB={1:1,07:2,13:3,   ,49:10,55:11,61:12 | l1:c1,l2:c2,l3:c3,...,l11:c11,l12:c12}]

or 

  devaddr devtype [host:]port SOCKDEV

Emulated Tape Devices

SCSI Tapes

General Format 

  devaddr devtype devname [--no-erg][--blkid-32 | --blkid-22]

Optical Media Attach (OMA) virtual files

General Format

devaddr devtype tdf

AWSTAPE virtual files

General Format 

  devaddr devtype {awsfile | *} [arguments]

where arguments can be: 

  
  [MAXSIZE={n[K | M | G | T] | 0} |MAXSIZEK={n | 0} |MAXSIZEM={n | 0}]
  [EOTMARGIN=n[K | M | G | T]]
  [READONLY={0 | 1}][RO | NORING | RW | RING]
  [DEONIRQ={0 | 1}]
  [NOAUTOMOUNT]

HET virtual files

General Format 

  devaddr devtype {hetfile | *} [arguments]

where arguments can be: 

  [AWSTAPE]
  [COMPRESS={0 | 1}]
  [IDRC={0 | 1}]
  [METHOD={1 | 2}]
  [LEVEL={n | 4}]
  [CHUNKSIZE={nnnnn | 65535}]
  [MAXSIZE={n[K | M | G | T] | 0} |MAXSIZEK={n | 0} |MAXSIZEM={n | 0}]
  [EOTMARGIN=n[K | M | G | T]]
  [READONLY={0 | 1}]
  [STRICTSIZE={0 | 1}]
  [RO | NORING | RW | RING]
  [DEONIRQ={0 | 1}]
  [NOAUTOMOUNT]

Fake Tape virtual files

General Format 

  devaddr devtype {fakefile | *} [arguments]

where arguments can be: 

  [MAXSIZE={n[K | M | G | T] | 0} |MAXSIZEK={n | 0} |MAXSIZEM={n | 0}]
  [EOTMARGIN=n[K | M | G | T]]
  [READONLY={0 | 1}]
  [RO | NORING | RW | RING]
  [DEONIRQ={0 | 1}]
  [NOAUTOMOUNT]

Channel-to-Channel Adapters

CTCI (Channel-to-Channel link to TCP/IP stack)

General Format 

  devaddr CTCI [{-n | --dev} name][{-s | --netmask} mask]
         [{-m | --macaddr} mac | 00:00:5E:nn:nn:nn}]
         [{-t | --mtu} mtu | 1500]
         [{-i | --ibuff} {ibuff | 64}]
         [{-k | --kbuff} {kbuff | 1024}]
         [-d | --debug]
  guestip hostip

CTCT (Channel-to-Channel emulation via TCP connection)

General Format 

  devaddr CTCT sport rhost rport bufsize

CTCE (Enhanced Channel-to-Channel emulation via TCP connection)

General Format 

  devaddr CTCE lport raddress rport [mtu [sml]]

LCS (LAN Channel Station)

General Format 

  devaddr LCS [{-n | --dev} name] 
      [{-o | --oat} file] 
      [{-m | --mac} mac] 
      [-d | --debug]
      [guestip]
      | 0400 | IP  | 00 | PRI |172.021.003.032  |
      | 0402 | IP  | 00 | SEC |172.021.003.033  |
      | 0404 | IP  | 00 | NO  |172.021.003.038  |
      | 0406 | IP  | 01 | NO  |172.021.002.016  |
      | 040E | SNA | 00 |     |                 |
      HWADD 00 02:00:FE:DF:00:42
      HWADD 01 02:00:FE:DF:00:43
      ROUTE 00 172.021.003.032 255.255.255.224

PTP (MPCPTP / PCPTP6 Channel-to-Channel link)

General Format 

  devaddr PTP [{-n | --dev} name]
          [{-m | --mac} mac]
          [{-t | --mtu} mtu | 1500]
          [{-i | --ibuff} {ibuff | 64}]
          [{-k | --kbuff} {kbuff | 1024}]
          [-4 | --inet]
          [-6 | --inet6]
          [-d | --debug]
  guest1 host1  [guest2 host2]

FBA DASD Devices

General Format 

  devaddr devtype filename [origin | 0] [numblks][sf=shadowfile] [SYNCIO]

or 

  devaddr devtype ipname [:port | :3990] [:devnum]

4.1 CKD DASD Devices

General Format 

  
  devaddr devtype filename [sf=shadowfile]
      [{NOSYNCIO | SYNCIO}] [READONLY]
      [FAKEWRITE] [CU=type]

or 

  
  devaddr devtype ipname [:port | :3990] [:devnum]

Default CU Types

Device Type Default CU Type
2305, 2311, 2314 2841
3330,3375, 3340,3380 3350, 3880
3390 3990
9345 9343

Table 5: Default CU Types

Communication Lines

Communication Line - BSC

General Format  

  devaddr devtypeDIAL={IN | OUT | INOUT | NO} 
      LHOST={hostname | ipaddress | *} 
      LPORT={servicename | port} 
      RHOST={hostname | ipaddress} 
      RPORT={servicename | port} 
      [RTO={0 | -1 | nnn | 3000}] 
      [PTO={0 | -1 | nnn | 3000}] 
      [ETO={0 | -1 | nnn | 10000}]

Communication Line - TTY

General Format 

  devaddr devtype LPORT=port DIAL=IN
  TTY=1

# (Comment line)

General Format 

  # [//anything//]

General Format

* [anything]

General Format 

  ARCHLVL {S/370 | ESA/390 | ESAME | z/ARCH}
      or
  ARCHLVL {ENABLE | DISABLE} facility [S/370 | ESA/390 | z/ARCH]
      or
  ARCHLVL {ENABLE | DISABLE} bitno[S/370 | ESA/390 | z/ARCH]
      or
  ARCHLVL QUERY [facility | ALL]

ARCHMODE (Initial architecture mode)

Alias

ARCHMODE is an alias for the ARCHLVL system parameter. Please see ARCHLVL for details.

ASN_AND_LX_REUSE / ALRF (ESAME ASN and LX REUSE feature)

Deprecation

The ASN_AND_LX_REUSE (ALRF) system parameter has been deprecated.Use “ARCHLVL ENABLE | DISABLE ASN_LX_REUSE” instead.

AUTO_SCSI_MOUNT (Automatic SCSI tape mounts)

The AUTO_SCSI_MOUNT system parameter has been deprecated. Use “SCSIMOUNT” instead.

AUTOMOUNT (Tape automount root directory)

General Format 

  AUTOMOUNT [+ | -] directory or AUTOMOUNT {ADD directory | DEL directory}

AUTOINIT (Automatic creation of empty tape files)

General Format 

  AUTOINIT {ON | OFF}

General Format 

  CAPPING {mips | OFF | 0}

General Format 

  CCKD option=value [ ,option=value ... ]
   where option can be:
  [COMP={-1 | n}][,COMPPARM={-1
  | n}]
  [,RA={2 | n}][,RAQ={4 | n}][,RAT={2 | n}][,WR={2 | n}][,GCINT={10 | n}]
  [,GCPARM={0 | n}]
  [,NOSTRESS={0 | 1}]
  [,FREEPEND={-1 | n}]
  [,FSYNC={0 | 1}]
  [,TRACE={0 | n}]
  [,LINUXNULL={0 | 1}]
  [,GCSTART={0 | 1}]

General Format 

  CMDLEVEL %%{{%% + | -} {ALL | OPERator | MAINT | PROGrammer | CONFIGuration | DEVELoper | DEBUG} [...]}

CMDLVL (Set command group)

CMDLVL is an alias for CMDLEVEL. See CMDLEVEL system parameter for details.

CMDSEP (Command line seperator)

General Format 

  CMDSEP {char | OFF}

CNSLPORT (Console port)

General Format 

  CNSLPORT {3270 | port | host:port}

General Format 

  CODEPAGE {DEFAULT | codepage | USER |MAINT cmd [operands]}

CONKPALV (Console and telnet clients keep-alive option)

General Format 

  CONKPALV {(3,1,10) | (idle,intv,count)}

CP_UPDT (User character conversion table)

General Format 

  CP UPDT command [operands]

where command can be: 

  ALTER {EBCDIC | ASCII | G2H | H2G}
  (pos,val[,pos,val]...)
  DISPLAY {EBCDIC | ASCII | G2H | H2G }
  EXPORT {EBCDIC | ASCII | G2H | H2G } filename
  IMPORT {EBCDIC | ASCII | G2H | H2G } filename
  REFERENCE [codepage]RESETTEST

CPUIDFMT (Set format BASIC / 0 / 1 STIDP ge­neration)

General Format 

  CPUIDFMT {BASIC | 0 | 1}

CPUMODEL (CPU model number)

General Format 

  CPUMODEL {0586 | model}

CPUPRIO (CPU thread process priority)

General Format

CPUPRIO {15 | nn}

CPUSERIAL (CPU serial number)

General Format

CPUSERIAL {000001 | serial}

CPUVERID (CPU version code)

General Format 

  CPUVERID 00             (For z/ARCH and ESAME) orCPUVERID {FD | verid}      
  (For S/370 and ESA/390)

DEFSTORE (Define main and expanded storage)

General Format 

  DEFSTORE {[MAIN msize[B | K | M | G | T | P | E] [UNLOCK | LOCK]][{XSTOR |
  EXPANDED} xsize[M | G | T][UNLOCK | LOCK]]}

DEFSYM (Define a symbol)

General Format 

  DEFSYM symbol value

DEVPRIO (Device threads process priority)

General Format 

  DEVPRIO {8 | nn}

DEVTMAX (Maximum number of device threads)

General Format 

  DEVTMAX    {0 | -1 | 1-n}

DIAG8CMD (DIAGNOSE 8 command option)

General Format 

  DIAG8CMD {DISABLE | ENABLE [ECHO | NOECHO]}

ECPSVM (ECPS:VM support status (VM))

General Format 

  ECPSVM {Help |  STats | DISable | ENable | DEBUG | NOdebug | Level [nn]}

ENGINES (Processor engines type)

General Format 

  ENGINES [nn*] {CP | IL | AP | IP} [, ... ]

HAO (Hercules Automatic Operator)

General Format 

HAO    command    [   operands   ]

where command can be: 

  TGT    target
  CMD    consolecmd
  DEL    nn
  CLEAR
  LIST [   nn   ]

HERCLOGO (Hercules logo file)

General Format

HERCLOGO filename

HERCPRIO (Hercules process priority)

General Format

HERCPRIO {0 | nn}

HTTP (HTTP server configuration)

General Format 

  HTTP {START |
  STOP | ROOT path |PORT port {NOAUTH | AUTH userid password}}

HTTPPORT (HTTP server port)

  The HTTPPORT
  system parameter has been deprecated. Use “HTTP PORT” instead.

HTTPROOT (HTTP server root directory)

The HTTPROOT system parameter has been deprecated. Use “HTTP ROOT” instead.

IGNORE (Ignore subsequent INCLUDE errors)

General Format 

  IGNORE INCLUDE ERRORS

INCLUDE (Include configuration file)

General Format

INCLUDE //filepath//

IODELAY (I/O interrupt wait time (LINUX))

General Format

IODELAY {0 | usecs [NOWARN]}

LDMOD (Additional dynamic load modules)

General Format 

  LMOD module [module [module ...]]

LEGACYSENSEID (SENSE ID CCW (x'E40) fea­ture)

General Format 

  LEGACYSENSEID {OFF | DISABLE | ON | ENABLE}

LOADPARM (IPL parameter)

General Format 

  LOADPARM ipl parameter

LOGOPT (Logging options)

General Format 

  LOGOPT {TIMESTAMP | TIME | NOTIMESTAMP | NOTIME}

LPARNAME (LPAR name returned by DIAG x'204')

General Format 

  LPARNAME
  {HERCULES | 7parname}

LPARNUM (LPAR identification number)

General Format 

  LPARNUM {BASIC | 1 | n | nn}

MAINSIZE (Main storage size)

General Format 

  MAINSIZE size[B | K | M | G | T | P | E][UNLOCK | LOCK]

MANUFACTURER (STSI manufacturer code)

General Format 

  MANUFACTURER {HRC | name}

MAXCPU (Maximum number of CPUs)

General Format 

  MAXCPU {1 | nn}

MAXRATES (MIPS/SIO rate reporting interval)

General Format 

  MAXRATES {interval |
  MIDNIGHT}

MEMLOCK (Lock Hercules memory)

General Format

MEMLOCK {ON | OFF}

MODEL (STSI model code)

General Format 

MODEL {  EMULATOR   |    hdwmod    | = | *}  [  EMULATOR   |    capmod    | = | *  [   prmmod    | = | *  [   tmpmod    | = | *]]]

MODPATH (Dynamic load module path)

General Format 

  MODPATH path

MOUNTED_TAPE_REINIT (Control tape initiali­zation)

General Format 

  MOUNTED TAPE REINIT {ENABLE | ALLOW |DISABLE |
  DISALLOW}

MSGHLD (Timeout of held messages)

General Format 

  MSGHLD {nnn | INFO | CLEAR}

MSGLEVEL (Message display output)

General Format 

  MSGLEVEL {option  option ...} 
  
  where option can be:
    ON|OFF |  TEXT  | TIME | NODEBUG |
    [+|-]  DEBUG    |
    [+|-]  TAPE     |
    [+|-]  DASD     |
    [+|-]  COMM     |
    [+|-]  UR       |
    [+|-]  SCSI     |
    [+|-]  CTCA     |
    [+|-]  GRAF     |
    [+|-]  THREAD   |
    [+|-]  CHANNEL  |
    [+|-]  VERBOSE  |
    [+|-]  TERSE

MSGLVL (Message display output)

  MSGLVL is an
  alias for MSGLEVEL. See MSGLEVEL for details.

NUMCPU (Number of emulated CPUs)

General Format 

  NUMCPU {1 | nn}

NUMVEC (Number of vector facilities)

General Format 

  NUMVEC {0 | nn}

OSTAILOR (Tailor trace information for specific operating system)

General Format 

  OSTAILOR {[+ | -] z/OS | OS/390 | VM | VSE |
  zVSE |LINUX |
  OPENSOLARIS | QUIET | NULL}

PANRATE (Console refresh rate)

General Format 

  PANRATE
  {SLOW | FAST | rate}

PANTITLE (Console window title)

General Format 

  PANTITLE {text | "text text text" | ""}

PGMPRDOS (LPP license setting)

General Format 

  PGMPRDOS {RESTRICTED |
  LICENSED}

PLANT (STSI plant code)

General Format 

  PLANT {ZZ | name}

QUITMOUT (Quit timeout value)

General Format 

  QUITMOUT nn

REXX (REXX Interpreter)

General Format 

  REXX option where option can be:
  ENABLE | START [REGINA | OOREXX]
  DISABLE | STOP
  PATHS | REXXPATHS {path [delimiter path ...] | RESET}
  SYSPATH {ON | OFF | RESET}
  EXTENSIONS | SUFFIXES {suffix[delimiter suffix ...] | RESET}
  RESOLVER {ON | OFF | RESET}
  MSGLEVEL {0 | 1 | RESET}
  MSGPREFIX {messageprefix | OFF | RESET}
  ERRPREFIX {errorprefix | OFF | RESET}
  MODE {COMMAND | SUBROUTINE}

SCLPROOT (SCLP base directory)

General Format 

  SCLPROOT {NONE | directory}

SCPECHO (Echo to console and history of SCP replies)

General Format 

  SCPECHO {OFF |
  ON}

SCPIMPLY (Pass non-Hercules commands to the SCP)

General Format 

  SCPIMPLY {OFF | ON}

SCSIMOUNT (Automatic SCSI tape mounts)

General Format 

  SCSIMOUNT
  {NO | YES | n}

SHCMDOPT (Shell command option)

General Format 

  SHCMDOPT {DISABLE | ENABLE [DIAG8 | NODIAG8]}

SHOWDVOL1 (Enable showing of DASD vol-sers in device list)

General Format 

  SHOWDVOL1 {NO | YES | ONLY}

SHRDPORT (Shared device server port)

General Format 

  SHRDPORT [3990 | port | START |
  STOP]

SRVPRIO (Server threads priority)

General Format 

  SRVPRIO {4 | nn}

SYSEPOCH (Base date for TOD clock)

General Format 

  SYSEPOCH {1900 | 1960 | year [+years | -years]}

SYMPTOM (Instruction trace display option)

  SYMPTOM is
  an alias for the TRACEOPT system parameter. Please see TRACEOPT for details.

TIMERINT (Internal timer update interval)

General Format 

  TIMERINT {50 | interval}

TODDRAG (TOD clock drag factor)

General Format 

  TODDRAG {1.000000 | factor}

TODPRIO (Timer thread process priority)

General Format 

  TODPRIO {-20 | nn}

TRACEOPT (Instruction trace display option)

General Format 

  TRACEOPT {TRADITIONAL
  | REGSFIRST | NOREGS}

TZOFFSET (TOD clock offset from GMT)

General Format 

  TZOFFSET {0000 | #hhmm | -hhmm}

XPNDSIZE (Expanded storage size)

General Format 

  XPNDSIZE size[M | G | T] [UNLOCK | LOCK]

YROFFSET (TOD clock offset from actual date)

General Format 

  YROFFSET {#years | -years}

Process and Thread Priorities

This section covers details regarding the priority settings within Hercules. The relevant system parame- ters are:

  • CPUPRIO
  • DEVPRIO
  • HERCPRIO
  • SRVPRIO
  • TODPRIO

Process Priorities

Unix Process Priority Windows Priority Class Meaning
-20 to -16 Realtime

Process that has the highest possible priority. The threads of the process preempt the threads of all other processes, inclu- ding operating system processes performing important tasks. For example, a real-time process that executes for more than a very brief interval can cause disk caches not to flush or cause the mouse to be unresponsive.

-15 to -9 High

Process that performs time-critical tasks that must be executed immediately. The threads of the process preempt the threads of normal or idle priority class processes. An example is the Task List, which must respond quickly when called by the user, re- gardless of the load on the operating system. Use extreme care when using the high-priority class, because a high-priority class application can use nearly all available CPU time.

-8 to -1 Above Normal

Process that has priority above the Normal class but below the High class.

0 to 7 Normal Process with no special scheduling needs.
8 to 15 Below Normal

Process that has priority above the Idle class but below the Normal class.

16 to 20 Low

Process whose threads run only when the system is idle. The threads of the process are preempted by the threads of any process running in a higher priority class. An example is a screen saver. The idle-priority class is inherited by child pro- cesses.

Windows

Caution: On Windows, the value you choose for your process priority has a direct impact on how your thread priorities are interpreted! You should never modify one without understanding what impact you are doing so might have on the other!

Thread Priorities

Unix Thread Priority Windows Thread Priority Meaning
-20 to -16 Time Critical

Base priority of 15 for Idle, Below Normal, Normal, Above Normal, or High class processes, and a base priority of 31 for Realtime class processes.

-15 to -9 Highest Priority 2 points above the priority class.
-8 to -1 Above Normal Priority 1 point above the priority class.
0 to 7 Normal Normal priority for the priority class.
8 to 15 Below Normal Priority 1 point below the priority class.
16 to 19 Lowest Priority 2 points below the priority class.
20 Idle

Base priority of 1 for Idle, Below Normal, Normal, Above Normal, or High class processes, and a base priority of 16 for Realtime class processes.

Windows

Caution: On Windows, your Thread Priority is interpreted differently based on your chosen Process Prio- rity setting! You should never modify your Thread Priority settings without first reviewing your chosen Pro- cess Priority setting!

ibm/hercules/userref/system.parameters.txt · Last modified: 2023/08/06 13:31 by Site Administrator