Modification of the default values in the System Environment

You can modify the default values in the System Environment.

However, do so only when you need to modify the default values in the System Environment for operational reasons.

It is normally recommended that you only make modifications to the System Environment Settings file (HULFT.PARMLIB(HULPRM)), without changing the default values.

Note

  • If you perform the procedure explained here, modifications will be made to the environment in which you are currently using HULFT. Before performing this procedure, be sure to refer to Backup in HULFT Ver.8 and create a backup for HULFT load module library.

  • Since members of the library are updated, the capacity of the existing HULFT load module library may be insufficient.

  • If you modify the default values for tag names that do not have default values, shown in the list of System Environment Settings in Administration Manual, you will be unable to return them to their default values. In this case, restore HULFT load module library from the backup.

  • After you use this program, rerun the following HULFT resident programs:

    • Send program (XRSND)

    • Receive program (XRRCV)

    • Observe program (XRACCPT)

System Environment Settings Default Value Modification Program (XRPRMSET)

Program Name

XRPRMSET

Execution parameters (for EXEC statement)

PARM='SOURCE=XXXXXXXX, OBJIN=XXXXXXXX, OBJOUT=XXXXXXXX'

SOURCE

Source DD Name

You can specify a source DD name for the assembler program. If this parameter is not specified, the default value 'SYSIN' is used.

OBJIN

Object program input DD name

You can specify an input DD name for the object program of the assembler program. If this parameter is not specified, the default value 'SYSLIN' is used.

OBJOUT

Object program output DD name

You can specify an output DD name for the object program of the assembler program. If this parameter is not specified, the default value 'SYSLIN' is used.

XRSYSIN Definition Card

Definition Card Format

START-TASK=Job Name of Send Program 
UNIT=UNIT Name of Send Work Files 
PORTNO=Receive Port No. 
TASK-CNT=Send Startup Task Count 
SNDBNO=I/O Buffer Count for Sending 
RCVBNO=I/O Buffer Count for Receiving 
TCPIP=Address Space Name of TCP/IP 
TASK-ABEND=Abend Processing of Send Subtask 
HOST-NAME=Local Host Name 
DOMAIN=Local Domain Name 
HSTCHA=Case Options for Local Host Name or Local Domain Name 
DATACHK=Data Count Check 
RETRY=Retry Count on Connection Error 
RESENDDEL=Criteria to Delete Resend Queue 
PREFIX=First Modifier of Send Work Files 
RECLEN=Shiftcode Mode for Send Files 
CMPBLK=Work File Block Length for Compression 
JOBTIME=Job Timeout for Pre-send Job 
TIMEOUT=Socket Read Timeout 
SCANMODE=Handling of Cancelation of Synchronous Transfer 
RCVOVER-RTY=Receive Multiplex Level Over Retry 
CLEARMODE=Post-send Clear Mode 
ENDERRMODE=Send Transfer Error Handling 
STATUSDISPLAY=Status Display Selection 
TGRPCHK=Transfer Group Check 
HSTCHK=Host Check 
LOGDELTHRESHOLD=Log Deletion Threshold 
LOGKEEPCOUNT=Log Keep Count 
EBCDIC=Conversion between EBCDIC Codes 
PSCHG=Pack Zone Conversion 
PSASCII=Sign for ASCII 
PSEBCDIC=Sign for EBCDIC 
GAIJIFILE=Use Custom Character Table 
GAIJIERR=Process when Custom Character has not been Registered 
DYNAMIC-DIRECT=Direct Transfer Mode for Dynamic Specification 
INIT-UNIT=UNIT Name of Send Files and Receive Files 
WORKVOLMODE=Work Volume Mode 
JESC=JES Command Acronym 
JLIB1=Subsequent Job Addition Step STEPLIB Settings 1 
JLIB2=Subsequent Job Addition Step STEPLIB Settings 1 
JLIB3=Subsequent Job Addition Step STEPLIB Settings 1 
JELIB1=Subsequent Job Addition Step STEPLIB Settings 2 
JELIB2=Subsequent Job Addition Step STEPLIB Settings 2 
JELIB3=Subsequent Job Addition Step STEPLIB Settings 2 
SNDRETRY=Retry Count for Accessing Send Files 
SNDRTIME=Retry Interval for Accessing Send Files 
EUCSP=Space Code Mode During EUC Code Conversion 
KEISSPMODE=KEIS Em-size Space Mode 
SOCKERR-AUTORETRY=Retry Count on Auto Resend 
RETRYTIME=Retry Count on Auto Resend or Connection Error 
MSGDYNPARM=Message Dynamic Parameter Specification 
RECV-TASK=Receive Task Name 
CIPHERTYPE=Encryption Scheme 
REQWAITMODE=Wait Synchronous Observe Mode 
CONSMSG=User-Specific Message 
DEFER=Deferred Mount 
JOBNM=Job Name 
CLASS=Class 
MSGCLASS=Message Class 
JOBOP1=Job Operand 1 
JOBOP2=Job Operand 2 
SERIALNO=Serial Number 
PRODUCTKEY=Product Key 
TERMLICENSEKEY=Term License Key 
APTHSTCHK=Observe Host Check 
USRIDCHKMODE=User ID/Password Check 
PROCTRANSTYPE=Framed Message Transfer Type 
JCLRETRY=JCL Library Retry Count 
JCLRTIME=JCL Library Retry Interval 
OPLSELECT=Operation Log Output Option 
OPLCMD1=Command Execution Log Output Data Set Name 1 
OPLCMD2=Command Execution Log Output Data Set Name 2 
OPLFILE1=File Access Log Output Data Set Name 1 
OPLFILE2=File Access Log Output Data Set Name 2 
OPLCHARACTER=Operation Log User-specified Character 
OPLEBCDIC=Operation Log EBCDIC Code 
OPLCMDBKVOL=Command Execution Log Backup Output Volume Name 
OPLFILEBKVOL=File Access Log Backup Output Volume Name 
OPLUNIT=UNIT Name of Operation Log Output Data Set 
OPLCMDBK=Command Execution Log Backup Output Data Set Name 
OPLFILEBK=File Access Log Backup Output Data Set Name 
OPLBKJOBNM=Operation Log Auto Switch Job Name 
HULPRMFILE=System Environment Settings File Name(*1) 
CNVLENCHK=Handling of Data Exceeded Max Length after Code Conversion 
HULLANG=HULFT Operation Language 
DATEFMT=Date Format 
SNDSOCKSIZE=Socket Buffer Size for Data Sending 
RCVSOCKSIZE=Socket Buffer Size for Data Receiving 
SND-SEQNO-THRESHOLD=Send SEQ No. Threshold 
RESND-QUELISTNO-THRESHOLD=Resend Queue List No. Threshold 
TTMODE=Transfer Preference 
TTRCVOMIT=Result Handling of Receiving 
TTRCVFILOUTPUT=Output Receive File 
TTPRESNDJOB=Execute Pre-send Job 
TTSNDJOB=Execute Post-send Job 
TTRCVJOB=Execute Post-receive Job 
TTSNDRCVLOG=Output Results to Transfer Logs 
OUTSTSKID=Output Subtask ID 
CNSSELECT=Console Message Output Option 
SAN-VER5=HULFT-SAN V5 Product 
RPREFIX=First Modifier of Receive Work Files 
HULCHARSET=HULFT Character Set 
CS4TRNSFR=Code Set for Transfer 
INDOPTVAR=Indicator Options for Environment Variable 
LISTEN=Queue of Pending Connect 
SND-START-MODE=Send Start Mode 
RCV-APPLNM=Receive Application Name 
RCV-MAXCON=Receive Multiplex Level 
RCV-RECCHK=Receive Record Length Check 
RCV-FILE-WAIT=Handling of Receive Files While in Use 
RCV-FILE-SEARCH=Search Scope for Receive File 
RCV-FILE-RETRY=Retry Count for Receive File 
RCV-FILE-RTIME=Retry Interval for Receive File 
RCV-JOBWTIME=Post-Receive Job Execution Timeout 
RCV-CHRSET=Pad Character 
RCV-TIMEOUT=Socket Read Timeout 
APT-APPLNM=Observe Application Name 
APT-MAXCON=Maximum Simultaneous Requests 
APT-TIMEOUT=Observe Socket Read Timeout 
ALLOWSNDREQ=Allow Send/Resend Request from Unregistered Host 
ALLOWPOSTRJOBRSLT=Allow Post-Receive Job Result Inquiry from Unregistered Host 
ALLOWJOBRSLTNTFY=Allow Job Result Notification Request from Unregistered Host 
ALLOWRMTJOBEXE=Allow Remote Job Execution Request from Unregistered Host 
ALLOWINSTTRANS=Allow Instant Transfer from Unregistered Host 
INSTTRANSCODCNV=Instant Transfer Code Conversion Side 
INSTTRANSEBCDIC=Instant Transfer EBCIDIC Set 
INSTTRANSRCVUNIT=Instant Transfer Receive File Unit 
INSTTRANSRCVSPACE=Instant Transfer Receive File Capacity 
INSTTRANSRCVDCB=Instant Transfer Receive File DCB 
INSTTRANSMFRCVORG=Inter-Mainframe Instant Transfer Receive Attribute Value Source 
INSTTRANSCMDQUE=Send Control File to Issue Instant Transfer 
CONSOLELOG=Output Toggles By Message Severity Level 
CONS-MSGFILTER=Message Filter File 
CONTROL-FILE=System Control File 
INSTTRANSDSNLST=Instant Transfer Receive File Naming File 
INSTTRANSVOLLST=Instant Transfer Receive Volumes File 
STRONGKEYMODE=Forced Strong Key Mode
CODE-CONVERSION-LOCATION=Storage for Code Conversion Table
SYSFILEOUTPUTMODE=System File Output Mode

*1

:

Specify a name in compliance with the data set naming conventions of the operating system, using alphanumeric characters up to 54 bytes in length. You can specify Sequential Organization files and partitioned data sets (PDS).

If you omitted the JCL XRSYSIN definition card, HULFT refers to the settings in the System Environment Settings file (HULFT.PARMLIB(HULPRM)) specified for the 'HULPRMFILE=' tag to perform this operation.

If you modify the settings in the System Environment Settings file (HULFT.PARMLIB(HULPRM)) specified for the 'HULPRMFILE=' tag, all JCL jobs for which the XRSYSIN definition card was omitted are affected.
= Remarks =

  • For more information about the meanings and settings for each field in the System Environment Settings, refer to the explanation for configuring the System Environment Settings in Administration Manual.

  • When the first byte of a tag name is '*,' the line will be handled as a comment.

  • You can omit the definition card. The default values of omitted tag names are not modified.

Example of JCL

//XRPRMSET JOB  CLASS=A,MSGCLASS=B                                              
//XRPRMSET EXEC PGM=XRPRMSET,REGION=1024K                                       
//STEPLIB  DD   DSN=HULFT.LOAD,DISP=SHR                                         
//SYSLMOD  DD   DSN=HULFT.LOAD,DISP=SHR                                         
//SYSIN    DD   DSN=&&OBJECT,DISP=(,PASS,DELETE),                               
//             UNIT=SYSDA,SPACE=(CYL,(010)),                                    
//             DCB=(DSORG=PS,LRECL=80,RECFM=FB,BLKSIZE=3120)                    
//SYSLIB   DD   DSN=SYS1.MACLIB,DISP=SHR                                        
//SYSUT1   DD   UNIT=SYSDA,SPACE=(CYL,(10))                                     
//SYSUT2   DD   UNIT=SYSDA,SPACE=(CYL,(10))                                     
//SYSUT3   DD   UNIT=SYSDA,SPACE=(CYL,(10))                                     
//SYSLIN   DD   DSN=&&OBJECT2,DISP=(,PASS,DELETE),                              
//             UNIT=SYSDA,SPACE=(CYL,(010)),                                    
//             DCB=(DSORG=PS,LRECL=80,RECFM=FB,BLKSIZE=3120)                    
//SYSOUT   DD   SYSOUT=*                                                        
//SYSPRINT DD   SYSOUT=*                                                        
//XRSYSIN  DD   *                                                               
UNIT=SYSDA                                                                      
HOST-NAME=OS390                                                                 
SERIALNO=XXX-XXXX-XXXXXX                                                        
PRODUCTKEY=XXXXX-XXXXX-XXXXX-XXXXX-XXXXX                                        
//

DD Name

Value

Description

STEPLIB

HULFT.LOAD

HULFT load module library

SYSLMOD

HULFT.LOAD

HULFT load module library

Parameter Name

Value

Description

UNIT

SYSDA

UNIT

Status Code

Status Code

Description

0

The processing for modifying the default values in the System Environment ended successfully.

4

A warning occurred during the processing for modifying the default values in the System Environment.

12

An error occurred during the processing for modifying the default values in the System Environment.
= Remarks =

For details about messages, refer to Error Codes and Messages.