rsed.envvars, Arquivo de Configuração RSE

O daemon de bloqueio RSE e os processos do servidor RSE (daemon RSE, conjunto de encadeamentos RSE e servidor RSE) usam as definições em rsed.envvars. Serviços opcionais do Developer para System z e de terceiros também podem utilizar esse arquivo de configuração para definir variáveis de ambiente para seu uso.

O rsed.envvars está localizado em /etc/rdz/, a menos que você tenha especificado um local diferente quando customizou e enviou a tarefa FEK.SFEKSAMP(FEKSETUP). Consulte Configuração da Customização para obter mais detalhes. É possível editar o arquivo com o comando do TSO OEDIT.

Consulte o seguinte arquivo rsed.envvars de amostra, que deve ser customizado para corresponder ao ambiente do sistema.

Figura 5. rsed.envvars - Arquivo de configuração do RSE
#=============================================================
#=============================================================
# (1) definições necessárias
JAVA_HOME=/usr/lpp/java/J5.0
RSE_HOME=/usr/lpp/rdz
_RSE_LOCKD_PORT=4036
_RSE_JMON_PORT=6715
_RSE_HOST_CODEPAGE=IBM-1047
TZ=EST5EDT
LANG=C
PATH=/bin:/usr/sbin
_CEE_DMPTARG=/tmp
STEPLIB=NONE
#STEPLIB=$STEPLIB:CEE.SCEERUN:CEE.SCEERUN2:CBC.SCLBDLL
_RSE_JAVAOPTS=""
_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Xms1m -Xmx256m"
_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Ddaemon.log=/var/rdz/logs"
_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Duser.log=/var/rdz/logs"
_RSE_JAVAOPTS="$_RSE_JAVAOPTS -DDSTORE_LOG_DIRECTORY="
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Dmaximum.clients=60"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Dmaximum.threads=1000"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Dminimum.threadpool.process=1"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Dmaximum.threadpool.process=100"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Dipv6=true"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Dkeep.last.log=true"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Denable.standard.log=true"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Denable.port.of.entry=true"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Denable.certificate.mapping=false"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Denable.automount=true" 
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Denable.audit.log=true"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Daudit.cycle=30"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Daudit.retention.period=0"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Ddeny.nonzero.port=true"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Dsingle.logon=false"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Dprocess.cleanup.interval=0"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -DAPPLID=FEKAPPL"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -DDENY_PASSWORD_SAVE=true"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -DHIDE_ZOS_UNIX=true"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -DDISABLE_DELETE_IN_SUBPROJECT=true"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -DDSTORE_IDLE_SHUTDOWN_TIMEOUT=3600000"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -DDSTORE_TRACING_ON=true"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -DDSTORE_MEMLOGGING_ON=true"
#=============================================================
# (2) definições necessárias para o Gateway do Cliente TSO/ISPF
_CMDSERV_BASE_HOME=/usr/lpp/ispf
_CMDSERV_CONF_HOME=/etc/rdz
_CMDSERV_WORK_HOME=/var/rdz
#STEPLIB=$STEPLIB:ISP.SISPLOAD:ISP.SISPLPA:SYS1.LINKLIB
_RSE_CMDSERV_OPTS=""
#_RSE_CMDSERV_OPTS="$_RSE_CMDSERV_OPTS&ISPPROF=&SYSUID..ISPPROF"  
#=============================================================  
# (3) definições necessárias para o SCLM Developer Toolkit  
_SCLMDT_CONF_HOME=/var/rdz/sclmdt    
#STEPLIB=$STEPLIB:FEK.SFEKAUTH:FEK.SFEKLOAD   
#_SCLMDT_TRANTABLE=FEK.#CUST.LSTRANS.FILE   
#ANT_HOME=/usr/lpp/Apache/Ant/apache-ant-1.7.1   
#=============================================================   
# (4) definições opcionais   
#_RSE_PORTRANGE=8108-8118   
#_BPXK_SETIBMOPT_TRANSPORT=TCPIP   
#TMPDIR=/tmp 
#GSK_CRL_SECURITY_LEVEL=HIGH  
#GSK_LDAP_SERVER=ldap_server_url  
#GSK_LDAP_PORT=ldap_server_port  
Figura 6. rsed.envvars - Arquivo de configuração do RSE (continuado)
#GSK_LDAP_USER=ldap_userid  
#GSK_LDAP_PASSWORD=ldap_server_password  
#=============================================================
# (5) não altere, a menos que seja orientado pelo centro de suporte da IBM 
_RSE_SAF_CLASS=/usr/include/java_classes/IRRRacf.jar
_CEE_RUNOPTS="ALL31(ON) HEAP(32M,32K,ANYWHERE,KEEP,,) TRAP(ON)" 
_BPX_SHAREAS=YES 
_BPX_SPAWN_SCRIPT=YES 
JAVA_PROPAGATE=NO 
RSE_LIB=$RSE_HOME/lib 
PATH=.:$JAVA_HOME/bin:$RSE_HOME/bin:$_CMDSERV_BASE_HOME/bin:$PATH 
LIBPATH=$JAVA_HOME/bin:$JAVA_HOME/bin/classic:$RSE_LIB:$RSE_LIB/icuc 
LIBPATH=.:/usr/lib:$LIBPATH 
CLASSPATH=$RSE_LIB:$RSE_LIB/dstore_core.jar:$RSE_LIB/clientserver.jar 
CLASSPATH=$CLASSPATH:$RSE_LIB/dstore_extra_server.jar 
CLASSPATH=$CLASSPATH:$RSE_LIB/zosserver.jar 
CLASSPATH=$CLASSPATH:$RSE_LIB/dstore_miners.jar 
CLASSPATH=$CLASSPATH:$RSE_LIB/universalminers.jar:$RSE_LIB/mvsminers.jar 
CLASSPATH=$CLASSPATH:$RSE_LIB/carma.jar:$RSE_LIB/luceneminer.jar 
CLASSPATH=$CLASSPATH:$RSE_LIB/mvsluceneminer.jar:$RSE_LIB/cdzminer.jar 
CLASSPATH=$CLASSPATH:$RSE_LIB/mvscdzminer.jar:$RSE_LIB/jesminers.jar 
CLASSPATH=$CLASSPATH:$RSE_LIB/FAMiner.jar 
CLASSPATH=$CLASSPATH:$RSE_LIB/mvsutil.jar:$RSE_LIB/jesutils.jar 
CLASSPATH=$CLASSPATH:$RSE_LIB/lucene-core-2.3.2.jar 
CLASSPATH=$CLASSPATH:$RSE_LIB/cdtparser.jar 
CLASSPATH=$CLASSPATH:$RSE_LIB/wdzBidi.jar:$RSE_LIB/fmiExtensions.jar 
CLASSPATH=$CLASSPATH:$_RSE_SAF_CLASS 
CLASSPATH=.:$CLASSPATH 
_RSE_CMDSERV_OPTS="&SESSION=SPAWN$_RSE_CMDSERV_OPTS"   
_RSE_JAVAOPTS="$_RSE_JAVAOPTS -DISPF_OPTS='$_RSE_CMDSERV_OPTS'"  
_RSE_JAVAOPTS="$_RSE_JAVAOPTS -DA_PLUGIN_PATH=$RSE_LIB"   
_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Xbootclasspath/p:$RSE_LIB/bidiTools.jar"   
_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Dfile.encoding=$_RSE_HOST_CODEPAGE"  
_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Dconsole.encoding=$_RSE_HOST_CODEPAGE"   
_RSE_JAVAOPTS="$_RSE_JAVAOPTS -DDSTORE_SPIRIT_ON=true"   
_RSE_JAVAOPTS="$_RSE_JAVAOPTS -DSPIRIT_EXPIRY_TIME=6"  
_RSE_JAVAOPTS="$_RSE_JAVAOPTS -DSPIRIT_INTERVAL_TIME=6"   
_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Dcom.ibm.cacheLocalHost=true"   
_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Duser.home=$HOME"   
_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Dclient.username=$RSE_USER_ID"  
_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Dlow.heap.usage.ratio=15"   
_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Dmaximum.heap.usage.ratio=40"   
_RSE_JAVAOPTS="$_RSE_JAVAOPTS -DDSTORE_KEEPALIVE_ENABLED=true"   
_RSE_JAVAOPTS="$_RSE_JAVAOPTS -DDSTORE_KEEPALIVE_RESPONSE_TIMEOUT=60000"  
_RSE_JAVAOPTS="$_RSE_JAVAOPTS -DDSTORE_IO_SOCKET_READ_TIMEOUT=180000"   
_RSE_JAVAOPTS="$_RSE_JAVAOPTS -DRSECOMM_LOGFILE_MAX=0" 
_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Djob.monitor.port=$_RSE_JMON_PORT" 
_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Dlock.daemon.port=$_RSE_LOCKD_PORT"   
_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Dlock.daemon.cleanup.interval=1440"   
_RSE_JAVAOPTS="$_RSE_JAVAOPTS -showversion"   
_RSE_SERVER_CLASS=org.eclipse.dstore.core.server.Server   
_RSE_DAEMON_CLASS=com.ibm.etools.zos.server.RseDaemon   
_RSE_POOL_SERVER_CLASS=com.ibm.etools.zos.server.ThreadPoolProcess   
_RSE_LOCKD_CLASS=com.ibm.ftt.rse.mvs.server.miners.MVSLockDaemon  
_RSE_SERVER_TIMEOUT=120000  
_SCLMDT_BASE_HOME=$RSE_HOME  
_SCLMDT_WORK_HOME=$_CMDSERV_WORK_HOME  
CGI_DTWORK=$_SCLMDT_WORK_HOME  
#=============================================================  
# (6) variáveis adicionais de ambiente
JAVA_HOME
Diretório inicial Java. O padrão é /usr/lpp/java/J5.0. Altere para corresponder com a sua instalação doJava.
RSE_HOME
Diretório inicial do RSE. O padrão é /usr/lpp/rdz. Altere para corresponder à instalação do Developer para System z.
_RSE_LOCKD_PORT
Número da porta do daemon de bloqueio RSE. O padrão é 4036. Pode ser alterado, se desejado.
_RSE_JMON_PORT
Número de porta do JES Job Monitor. O padrão é 6715. Pode ser alterado, se desejado. Esse valor deve corresponder ao número de porta definido para o JES Job Monitor no arquivo de configuração FEJJCNFG. Se esses valores forem diferentes, o RSE não pode conectar o cliente ao JES Job Monitor.
_RSE_HOST_CODEPAGE
A página de códigos do host. O padrão é IBM-1047. Altere para corresponder à página de códigos do host.
TZ
Seletor de fuso horário. O padrão é EST5EDT. O fuso horário padrão é UTC +5 horas (horário de verão do horário padrão na costa leste dos Estados Unidos). Altere para corresponder ao fuso horário.
LANG
Especifica o nome do código do idioma padrão. O padrão é C. O C especifica o código do idioma POSIX e (por exemplo) Ja_JP especifica o código do idioma japonês. Altere para corresponder ao código do idioma.
STEPLIB
Acesse conjuntos de dados MVS que não estão no LINKLIST/LPALIB. O padrão é NONE.

É possível ignorar a necessidade de ter bibliotecas (pré-requisito) no LINKLIST/LPALIB ao remover o comentário e customizar uma ou mais das diretivas STEPLIB a seguir:

STEPLIB=$STEPLIB:CEE.SCEERUN:CEE.SCEERUN2:CBC.SCLBDLL
STEPLIB=$STEPLIB:ISP.SISPLOAD:ISP.SISPLPA:SYS1.LINKLIB
STEPLIB=$STEPLIB:FEK.SFEKAUTH:FEK.SFEKLOAD
Nota:
  • A utilização de STEPLIB no z/OS UNIX tem um impacto de desempenho negativo.
  • Se uma biblioteca STEPLIB for autorizada pelo APF, todas serão autorizadas. As bibliotecas perderão sua autorização do APF se forem combinadas com as bibliotecas no STEPLIB não autorizadas.
  • Bibliotecas que são projetadas para colocação de LPA podem exigir controle de programa adicional ou autorizações de APF se forem acessadas através de LINKLIST ou STEPLIB.
  • Codificar uma instrução STEPLIB DD no servidor JCL não configura a concatenação de STEPLIB necessária.
_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Ddaemon.log=/var/rdz/logs"
Diretório que contém o daemon RSE, a criação de log de servidor e os dados de auditoria do RSE. O padrão é /var/rdz/logs. Altere para aplicar o local desejado. Se essa diretiva for comentada, o diretório inicial do ID de usuário designado ao daemon RSE será usado. O diretório inicial é definido no segmento de segurança OMVS do ID do usuário.
_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Duser.log=/var/rdz/logs"
Diretório que conduz aos logs específicos do usuário. O padrão é /var/rdz/logs. Altere para aplicar o local desejado. Se esta diretiva tiver uma linha comentada, o diretório inicial do ID de usuário cliente será usado. O caminho do diretório é definido no segmento de segurança OMVS do ID do usuário.
Nota:
O caminho completo para os logs do usuário é userlog/dstorelog/$LOGNAME/, em que userlog é o valor da diretiva user.log, dstorelog é o valor da diretiva DSTORE_LOG_DIRECTORY e $LOGNAME é o ID do usuário do cliente, em maiúsculas.
_CMDSERV_BASE_HOME
O diretório inicial para o código do ISPF que fornece o serviço de Gateway do Cliente TSO/ISPF. O padrão é /usr/lpp/ispf. Altere para corresponder à sua instalação do ISPF.
_CMDSERV_CONF_HOME
Diretório de configuração base do ISPF. O padrão é /etc/rdz. Altere para corresponder ao local do ISPF.conf, o arquivo de customização do Gateway do Cliente TSO/ISPF.
_CMDSERV_WORK_HOME
Diretório de trabalho base do ISPF. O padrão é /var/rdz. Altere para corresponder ao local do diretório WORKAREA utilizado pelo Gateway do Cliente TSO/ISPF.
_RSE_PORTRANGE
Especifica o intervalo de portas que o servidor RSE pode abrir para comunicação com um cliente. Qualquer porta pode ser usada por padrão. Esta é uma diretiva opcional.