You use the CREATE-VIRTUAL-HOST command to take over a virtual host and its network view from the RDF or to define these directly by means of attributes. .
Any definitions that have been taken over cannot be undone.
The alias name CRVTHT exists for CREATE-VIRTUAL-HOST in order to provide SNMP support.
BS2000 console | BS2000 SDF command | Command/SOF file | SNMP management | Parameter service |
x | x | x | x |
List of valid command sources
CREATE-VIRTUAL-HOST / CRVTHT | ||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||
HOST-NAME=<composed-name 1..8> / <c-string 1 .. 32>
Name of the virtual host that is to be created.
ATTRIBUTES=...
Specifies the network description attributes present in the virtual host (and its network view).
ATTRIBUTES=*BY-RDF-FILE(...)
The description of the virtual host (and its network view) is taken from an RDF file.
RDF-FILE-NAME=...
You must specify an RDF file name.
RDF-FILE-NAME=*STD
The RDF file used for DCOPT/DCSTART is used.
RDF-FILE-NAME=<filename 1..54>
File name of the RDF file.
If the file is not available under the system administrator ID TSOS, then the file name must be specified in fully qualified form with USERID.
The RDF must always be cataloged in the home pubset, otherwise errors may occur in connection with files cataloged on data pubsets or shared pubsets.
ATTRIBUTES=*PARAMETERS(...)
The definition of the virtual host is taken from the following operands.
SOCKETHOST-NAME=...
Specifies the socket host name of the virtual host.
SOCKETHOST-NAME=*HOST-NAME
The name of the virtual host, padded out with blanks to the length of the socket host name, is used as the socket host name.
SOCKETHOST-NAME=<composed-name 1..32> / <c-string 1..32>
Socket host name of the virtual host.
MAX-TSDU-SIZE=4096 / <integer 4096..65530>
This operand describes the maximum message length (in bytes) that the virtual host can receive.
STATUS-JV=...
Name of the job variable (JV) in which the status information for the virtual host is stored. For the layout refer to section "Event monitoring using BCAM job variables".
STATUS-JV=*NONE
No status information is stored in the job variable.
STATUS-JV=<filename 1..54 without-gen-vers>
File name of the job variable in which the status information of the virtual host is stored.
If the JV is not available under the system administrator ID TSOS, then the file name must be specified in fully qualified form with USERID.
The JV must always be cataloged in the home pubset, otherwise errors may occur in connection with JVs cataloged on data pubsets or shared pubsets.
If multiple hosts are defined in an RDF segment then the JV is assigned to the host that is specified in the command. In this case, no JVs can be assigned to the other hosts.
Command logging
Positive acknowledgments are supplied in news BCA0720, and negative acknowledgments in news BCA0728.
A description of the error messages that may be issued during command processing is provided in the table below.
Command return codes
(SC2) | Maincode | Meaning |
| CMD0001 | Command successfully processed |
| CMD0202 | Error in command |
| BCA0235 | JV <> cannot be used because of <> |
| BCA0728 | Host not created |
| BCA0768 | Syntax error in command |
| BCA077A | Incorrect route definition |
| BCA0825 | Not a BCAM host |
| BCA0728 | Host not generated |
| BCA0770 | Name already exists |
| BCA0777 | Interface used for... |
| BCA08E5 | Host unknown |
| BCA082B | RDF was generated with incorrect BCAMDEF version |
| BCA0833 | Name already exists |
| BCA0814 | BCAM is being terminated abnormally |
| BCA0816 | BCAM is terminating |
| BCA0766 | BCAM is not active |
Examples
Read information from the RDF specified on BCAM start:
/CREATE-VIRTUAL-HOST HOST-NAME=VHRDF
Dynamic specification of virtual host:
/CREATE-VIRTUAL-HOST HOST-NAME=VHTEST,ATTRIBUTES= -
/ *PARAMETERS(SOCKETHOST-NAME=SOCHOS#VHTEST)
/CREATE-VIRTUAL-HOST HOST-NAME=VHTEST1,ATTRIBUTES= -
/ *PARAMETERS(SOCKETHOST-NAME=SOCHOS#VHTEST1), -
/ ,STATUS-JV=JV.VHTEST1