TL1 Commands

This chapter describes the TL1 commands used in the Cisco ONS 15530 environment.

Each TL1 command must be less than or equal to 255 characters. Any command larger than 255 characters must be split into multiple commands

3.1 ACT-USER: Activate User


Section	ACT-USER Description
Category	Security
Security	Retrieve
Related Messages	CANC-USER: Cancel User DLT-USER-SECU: Delete User Security ED-USER-SECU: Edit User Security ENT-USER-SECU: Enter User Security RTRV-USER-SECU: Retrieve User Security
Input Format	ACT-USER:[<tid>]:<uid>:<ctag>::<pid>; Where: •<ctag> is the correlation tag. •<uid> is the user identifier, a string value with a maximum size of 16 characters. •<pid> is the user login password, a string value with a minimum size of 6 characters. •<tid> is the target identifier.
Input Example	To log into the NE, use the following: ACT-USER:ons155xx:admin:123::mypswd;
Errors	Errors are listed in Table 2-15.

3.2 ALW-MSG-ALL: Allow Message All

Use the command to transmit all REPT ALM, REPT EVT, and REPT SW autonomous messages.

3.3 ALW-SWDX-EQPT: Allow Switch Duplex Equipment


Section	ALW-SWDX-EQPT Description
Category	Redundancy configuration
Security	Maintenance
Related Messages	INH-SWDX-EQPT: Inhibit Switch Duplex Equipment SW-DX-EQPT: Switch Duplex Equipment
Input Format	ALW-SWDX-EQPT:[<tid>]:<aid>:<ctag>; Where: •<tid> is the target identifier. •<aid> is the access identifier. Valid values are SLOT-5 and SLOT-6. •<ctag> is the correlation tag.
Input Example	To switch between active and standby CPU switch modules, use the following: ALW-SWDX-EQPT:ons155xx:SLOT-6:123;
Errors	Errors are listed in Table 2-15.

3.4 CANC-USER: Cancel User


Section	CANC-USER Description
Category	Security
Security	Retrieve
Related Messages	ACT-USER: Activate User DLT-USER-SECU: Delete User Security ED-USER-SECU: Edit User Security ENT-USER-SECU: Enter User Security RTRV-USER-SECU: Retrieve User Security
Input Format	CANC-USER:[<tid>]:<uid>:<ctag>; Where: •<tid> is the target identifier. •<uid> is the user identifier. •<ctag> is the correlation tag.
Input Example	To log out of the NE, use the following: CANC-USER:ons155xx:admin:123;
Errors	Errors are listed in Table 2-15.

3.5 CPY-MEM: Copy Memory

The AID of the memory device is specified in the <fromdev> and <todev> fields. Optionally, these fields can be set to NULL and the necessary information can be specified as part of the user defined text string in <frommem> and <tomem>.


Section	CPY-MEM Description
Category	Memory management
Security	Maintenance
Related Messages	FORMAT-MEM: Format Memory RST-MEM: Restore Memory RTRV-MEM: Retrieve Memory
Input Format	CPY-MEM:[<tid>]::<ctag>::<frommem>,[<fromdev>],<tomem>,[<todev>]: [CMDMODE=<mode>]; Where: •<tid> is the target identifier. •<ctag> is the correlation tag. •<frommem> specifies the name of the source file to copy. •<tomem> specifies the name of the target file to which to copy the contents of the file specified in <frommem>. •<fromdev> indicates the name of the source device from which a file is copied. •<todev> indicates the name of the target device to which a file is copied. •<mode> indicates the mode of operation. Valid values are FRCD or NORMAL. In FRCD mode of operation, any existing file is overwritten. In NORMAL mode of operation, if a file is already present by the name specified in <tomem>, the copy request is denied. The default mode is NORMAL. Note If this command is used to copy a file to a TFTP location, then the CMDMODE parameter is ignored and any existing file is overwritten.
Input Example	To copy the configuration from running-config to startup-config, use the following: CPY-MEM:ons155xx::123::"running-config",,"startup-config"; Note The double quotes are optional in the previous example. To copy the configuration from a TFTP location, use the following: CPY-MEM:ons155xx::123::"tftp://172.20.46.50/admin/ons15540-i-mz",, "bootflash:ons15540-i-mz"; To copy an image over from the bootflash memory to the Flash PC card in slot0, use the following: CPY-MEM:ons155xx::123:: "bootflash:ons15540-i-mz",, "disk0:ons15540-i-mz"; To use the <fromdev> and <todev> parameters to specify the Flash PC devices involved, use the following: CPY-MEM:ons155xx::123::"ons15540-i-mz",BOOTFLASH, "ons15540-i-mz", DISK-0;
Errors	Errors are listed in Table 2-15.

3.6 DLT-CRS-OCH: Delete Cross Connects


Section	DLT-CRS-OCH Description
Category	Cross connects
Security	Maintenance
Related Messages	ENT-CRS-OCH: Enter Cross Connects RTRV-CRS-ALL: Retrieve Cross Connects All RTRV-CRS-OCH: Retrieve Cross Connects OCH
Input Format	DLT-CRS-OCH:[<tid>]:<from_aid>,<to_aid>:<ctag>; Where: •<tid> is the target identifier. •<from_aid> is the access identifier for the transmitting interface. Valid values are PORTGROUP-[1-4,7-10]-0-0, WAVEETHERPHY-[1-4,7-10]-0, WAVEETHERPHY-[1-4,7-10]-0-[1-4], TENGIGETHERPHY-[1-4,7-10]-0, or TENGIGETHERPHY-[1-4,7-10]-0-[1-4]. •<to_aid> is the access identifier for the receiving interface. Valid values are PORTGROUP-[1-4,7-10]-0-0, WAVEETHERPHY-[1-4,7-10]-0, WAVEETHERPHY-[1-4,7-10]-0-[1-4], TENGIGETHERPHY-[1-4,7-10]-0, or TENGIGETHERPHY-[1-4,7-10]-0-[1-4]. •<ctag> is the correlation tag.
Input Example	To delete the cross connects, use the following: DLT-CRS-OCH:ons155xx:PORTGROUP-1-0-0,WAVEETHERPHY-7-0-1:123;
Errors	Errors are listed in Table 2-15.

3.7 DLT-FFP-OCH: Delete Facility Protection OCH

This command behaves as if executed in forced mode. Upon deletion of a protection group, the system switches service to the working line, irrespective of the state of the working line.


Section	DLT-FFP-OCH Description
Category	APS
Security	Retrieve
Related Messages	ED-FFP-OCH: Edit Facility Protection RTRV-FFP-OCH: Retrieve Facility Protection OCH
Input Format	DLT-FFP-OCH:[<tid>]:<wkg_aid>,<prot_aid>:<ctag>; Where: •<tid> is the target identifier. •<wkg_aid> is the working port AID. Valid values are WAVEPATCH-slot-0-port, TRANSPARENT-slot-0-0, TENGIGETHERPHY-slot-0, or WDMSPLIT-0-subcard-port. •<prot_aid> is the protection port AID. Valid values are WAVEPATCH-slot-0-port, TRANSPARENT-slot-0-0, TENGIGETHERPHY-slot-0, or WDMSPLIT-0-subcard-port. •<ctag> is the correlation tag.
Input Example	To delete a facility protection group, use the following: DLT-FFP-OCH:ons155xx:WAVEPATCH-2-0-0,WAVEPATCH-2-0-1:125;
Errors	Errors are listed in Table 2-15.

3.8 DLT-IP: Delete IP

Use this command to delete IP related configurations on the network management Ethernet port or the OSC interface.


Section	DLT-IP Description
Category	IP configuration
Security	Retrieve
Related Messages	DLT-IPROUTE-STATIC: Delete IP Route Static ED-IP: Edit IP ENT-IP: Enter IP RTRV-IP: Retrieve IP RTRV-IPROUTE: Retrieve IP Route SQUEEZE-MEM: Squeeze Memory
Input Format	DLT-IP:[<tid>]:<aid>:<ctag>; Where: •<tid> is the target identifier. •<aid > is one of FE-0, FE-SBY-0, WAVE-slot-subslot, ETHERDCC-slot-0-0 and LOOPBACK-[0-255]. •<ctag> is the correlation tag.
Input Example	To delete related configurations on the NME port or the OSC interface, use the following: DLT-IP:ons155xx:FE-0:123;
Errors	Errors are listed in Table 2-15.

3.9 DLT-IPROUTE-STATIC: Delete IP Route Static


Section	DLT-IPROUTE-STATIC Description
Category	IP configuration
Security	Provisioning
Related Messages	DLT-IP: Delete IP ED-IP: Edit IP ENT-IP: Enter IP RTRV-IP: Retrieve IP RTRV-IPROUTE: Retrieve IP Route SQUEEZE-MEM: Squeeze Memory
Input Format	DLT-IPROUTE-STATIC:[<tid>]::<ctag>:::PREFIXADDR=<addr>, PREFIXMASK=<mask>, [ROUTEIF=<interface>],[ROUTEADDR=<routeaddr>]; Where: •<tid> is the target identifier. •<ctag> is the correlation tag. •<addr> is the IP address. •<mask> is the IP subnet mask. •<interface> is the static route interface AID. •<routeaddr> is the static route IP address.
Input Example	To delete IP static routes, use the following: DLT-IPROUTE-STATIC:ons155xx::123:::PREFIXADDR=10.1.0.0, PREFIXMASK=255.255.0.0, ROUTEIF=WAVE-1-0;
Errors	Errors are listed in Table 2-15.

3.10 DLT-MEM: Delete Memory

The file is simply marked as deleted but not erased from memory if the <aid> is BOOTFLASH or SBY-BOOTFLASH.


Section	DLT-MEM Description
Category	Memory management
Security	Provisioning
Related Messages	CPY-MEM: Copy Memory RST-MEM: Restore Memory RTRV-MEM: Retrieve Memory
Input Format	DLT-MEM:[<tid>]:<aid>:<ctag>:::FILENAME=<filename>; Where: •<tid> is the target identifier. •<aid> indicates the memory device from which the file is being deleted. Valid values are BOOTFLASH, DISK-0, SBY-BOOTFLASH and SBY-DISK-0. •<ctag> is the correlation tag. •<filename> is the filename.
Input Example	To delete a file from memory specified by the AID, use the following: DLT-MEM:ons155xx:DISK-0:123::"ons15540-i-mz";
Errors	Errors are listed in Table 2-15.

3.11 DLT-NBR: Delete Neighbor

Use this command to delete neighbor entries for a port or to disable learning through CDP on a port.

If LINKDIRN is specified, then only the neighbor entry for that particular direction is deleted. Otherwise, all neighbor entries on the port are deleted.

Note When neighbors are learned through CDP, LINKDIRN is always both, so the value specified in LINKDIRN is ignored.


Section	DLT-NBR Description
Category	Topology neighbor configuration
Security	Maintenance
Related Messages	ENT-NBR: Enter Neighbor RTRV-NBR: Retrieve Neighbor
Input Format	DLT-NBR:[<tid>]:<aid>:<ctag>:::[LINKDIRN=<linkdirn>]; Where: •<aid> identifies the interface and can be one of the following: –WDM-0-subcard –TRANSPARENT-slot-0-0 –ESCON-slot-0-port –VOAOUT-slot-subcard-port •<linkdirn > is the link direction, either one way or both ways. Both transmit and receive links of this port are connected to a neighbor specified by the rest of the command. –BOTH - The neighbor is on both the transmit and receive link of this port. BOTH is the default. –TX - The neighbor is on the transmit link of this port. –RX - The neighbor is on the receive link of this port. For direct links between nodes, LINKDIRN is set to BOTH because there is only one neighbor connected to the port. For configurations with an EDFA connected in one direction, use TX or RX, as appropriate, for the EDFA or neighboring node connected to the port.
Input Example	To delete a physical neighbor in the transmit direction, use the following: DLT-NBR:ons155xx:WDM-0-0:125:::LINKDIRN=TX;
Errors	Errors are listed in Table 2-15.

3.12 DLT-NTPASSOC: Delete NTP Associations


Section	DLT-NTPASSOC Description
Category	NTP
Security	Provisioning
Related Messages	ENT-NTPASSOC: Enter NTP Associations RTRV-NTP: Retrieve NTP RTRV-NTPASSOC: Retrieve NTP Associations
Input Format	DLT-NTPASSOC:[<tid>]::<ctag>:::ASSOCTYPE=<assoctype>, ASSOCIPADDR=<associpaddr>; •<tid> is the target identifier. •<ctag> is the correlation tag. •<assoctype> is the association type. Valid values are PEER or SERVER. •<associpaddr> is the association IP address.
Input Example	To delete an existing NTP association, use the following: DLT-NTPASSOC:ons155xx::123:::ASSOCTYPE=SERVER, ASSOCIPADDR=172.16.246.1;
Errors	Errors are listed in Table 2-15.

3.13 DLT-PATCH: Delete Patch

The CTYPE value for an existing patch cannot be edited. You must delete the patch and create a new patch with the new CTYPE value.


Section	DLT-PATCH Description
Category	Patch configuration
Security	Provisioning
Related Messages	ENT-PATCH: Enter Patch RTRV-PATCH: Retrieve Patch
Input Example	DLT-PATCH:<tid>:<from_aid>,<to_aid>:<ctag>; •<tid> is the target identifier. •<from_aid> identifies the port patched to the port identified by <to_aid>. Valid values for <from_aid> are as follows: –FILTER-0-subcard-0 –OSCFILTER-0-subcard –THRU-0-subcard –VOAFILTEROUT-slot-subcard-port –VOAFILTERIN-slot-subcard-port –VOAIN-slot-subcard-port –VOAOUT-slot-subcard-port –WAVE-subcard-slot –WAVEPATCH-slot-0-port –WDM-0-subcard •<to_aid> identifies the port ptached from the port identified by <from_aid>. Valid values for <to_aid> are as follows: –FILTER-0-subcard-0 –OSCFILTER-0-subcard –THRU-0-subcard –VOAFILTEROUT-slot-subcard-port –VOAFILTERIN-slot-subcard-port –VOAIN-slot-subcard-port –VOAOUT-slot-subcard-port –WAVE-subcard-slot –WAVEPATCH-slot-0-port –WDM-0-subcard •<ctag> is the correlation tag.
Input Example	To delete a patch configuration, use the following: DLT-PATCH:ons155xx:WDM-0-0,THRU-0-0:123;
Errors	Errors are listed in Table 2-15.

3.14 DLT-THR-OCH: Delete Threshold OCH

Use this command to delete either a complete alarm threshold list or particular thresholds within a list.

When deleting particular thresholds from a list, both the ERRTYPE and THRTYPE parameters must be specified.


Section	DLT-THR-OCH Description
Category	Threshold list configuration
Security	Provisioning Maintenance
Related Messages	ENT-THR-OCH: Enter Thresholds OCH RTRV-THR-OCH: Retrieve Thresholds OCH RTRV-TH-rr: Retrieve Threshold SET-TH-rr: Set Optical Threshold
Input Format	DLT-THR-OCH:[<tid>]:<THRLISTNAME>:<ctag>:::[ERRTYPE=<errtype>, THRTYPE=<thrtype>]; Where: •<tid> is the target identifier. •<thrlistname> specifies the threshold list. •<ctag> is the correlation tag. •<errtype> indicates the type of error counter to which the threshold applies. Valid values are as follows: –CVS - SONET/SDH section CV errors –CVRD - 8B/10B code violations and running disparity errors –CDLHEC - CDL HEC errors –CRC - Cyclic redundancy check errors •<thrtype> indicates the threshold type. Valid values are as follows: –DEGR - Indicates that a signal degrade condition has been reached. Use this threshold type only when <errtype> is CVS. –FAIL - Indicates that a signal failure condition has been reached. Use this threshold type only when <errtype> is CVS. –EVTTHR - Indicates that a non-service affecting condition has been reached. Use this threshold type when <errtype> is not CVS. –ALMTHR - Indicates that a service affecting condition has been reached. Use this threshold type when <errtype> is not CVS.
Input Example	To delete the threshold list or particular thresholds, use the following: DLT-THR-OCH:ons155xx:sonet-cvs:123;
Errors	Errors are listed in Table 2-15.

3.15 DLT-USER-SECU: Delete User Security


Section	DLT-USER-SECU Description
Category	Security
Security	Retrieve
Related Messages	ACT-USER: Activate User CANC-USER: Cancel User ED-USER-SECU: Edit User Security ENT-USER-SECU: Enter User Security RTRV-USER-SECU: Retrieve User Security
Input Format	DLT-USER-SECU:[<tid>]:<uid>:<ctag>; Where: •<tid> is the target identifier. •<uid> is the user identifier. •<ctag> is the correlation tag.
Input Example	DLT-USER-SECU:ons155xx:admin:123;
Errors	Errors are listed in Table 2-15.

3.16 ED-DAT: Edit Date

3.17 ED-ESCON: Edit ESCON


Section	ED-ESCON Description
Category	Escon interface configuration
Security	Provisioning
Related Messages	RTRV-ESCON: Retrieve ESCON
Input Format	ED-ESCON:[<tid>]:<aid>:<ctag>:::[RXFLOWID=<rxflowid>], [TXFLOWID=<txflowid>], [THRLISTNAME=<thrlistname>]:[<pst>]; Where: •<tid> is the target identifier. •<aid> indicates the escon interface to configure. A valid value is ESCON-slot-0-port. •<ctag> is the correlation tag. •<rxflowid> is the receive flow identifier. It is the flow identifier value received from the CDL network that identifies the elementary packet stream at this interface. You can set values ranging from 0 to the maximum allowed flow identifier (obtained using the RTRV-ESCON command). The default value is 255. Note This parameter can only be modified in the OOS state. •<txflowid> is the transmit flow identifier. It is the flow identifier value set in CDL packets in the elementary packet stream that are transmitted from this interface towards the CDL network. You can set values ranging from 0 to the maximum allowed flow identifier (obtained using the RTRV-ESCON command). The default value is 255. Note This parameter can only be modified in the OOS state. •<thrlistname> is the threshold list name. The threshold list sets thresholds for errors that are being monitored on this interface. The ampersand (&) operator associates multiple threshold lists with an interface. To delete a threshold list from an interface, enter a NULL value for the list name. Note A threshold list applied to one escon interface also applies to the other escon interfaces on the ESCON aggregation card. •<pst> is the primary state. The value set in this state determines if the interface is shut down or active. IS (in-service) renders the interface administratively up. OOS (out-of-service) administratively shuts down the interface. The default value is IS (in-service).
Input Example	To configure an escon port in slot 2, port 2, use the following: ED-ESCON:[<tid>]:ESCON-2-0-2:123:::RXFLOWID=20,TXFLOWID=20, THRLISTNAME=escon_thr;
Errors	Errors are listed in Table 2-15.

3.18 ED-FFP-OCH: Edit Facility Protection

Use this command to edit the attributes associated with an already created optical 1+1 protection channel and to put the protection group in-service or out-of-service. When the protection group is put out-of-service, then the currently active path continues to remain as the active path.


Section	ED-FFP-OCH Description
Category	APS
Security	Retrieve
Related Messages	DLT-FFP-OCH: Delete Facility Protection OCH RTRV-FFP-OCH: Retrieve Facility Protection OCH
Input Format	ED-FFP-OCH:[<tid>]:<wkg_aid>,<prot_aid>:<ctag>:::[PROTID=<protid>], [PSDIRN=<psdirn>], [RVRTV=<rvrtv>],[RVRTM=<rvrtm>], [YCABLE=<ycable>],[ENSWOTM=<enswotm>], [MSGCH=<msgch>], [MSGHOLDTM=<msgholdtm>], [MSGHOLDCOUNT=<msgholdcount>], [MSGMAXINTVTM=<msgmaxintvtm>], [FENDPROTID=<fendprotid>], [FENDIPADDR=<fendipaddr>]: [<pst>]; Where: •<tid> is the target identifier. •<wkg_aid> is the working port AID. Valid values are WAVEPATCH-slot-0-port, TRANSPARENT-slot-0-0, TENGIGETHERPHY-slot-0, or WDMSPLIT-0-subcard-port. •<prot_aid> is the protection port AID. Valid values are WAVEPATCH-slot-0-port, TRANSPARENT-slot-0-0, TENGIGETHERPHY-slot-0, or WDMSPLIT-0-subcard-port. •<ctag> is the correlation tag. •<protid> is the protection group identifier. It is a case-sensitive string and can have a maximum of 32 characters. If <protid> is not specified, a protection group name is created with the name of the <wkg_aid>. •<psdirn> is the protection switch direction. Switching mode. Valid values are UNI (unidirectional) and BI (bidirectional). The default is UNI. •<rvrtv> specifies the revertive mode. This feature applies only to y-cable protection. Valid values are Y or N. The default is N. •<rvrtm> is the revertive timer, which applies only if the revertive mode is enabled. The revertive timer specifies the interval to wait before performing a r revertive switch. The range is 0 to 720 seconds. The default is 300 seconds. •<ycable> specifies the y-cable mode. This parameter indicates whether the type of protection is y-cable or not. Valid values are Y or N. The default is N.
Input Format (continued)	•<enswotm> is the switchover enable timer. This timer is used to delay reenabling of auto-failover to prevent rapid switching between the standby and active links. The range of values is1 to 120 seconds. The default is 2 seconds. •<msgch> APS Message Channel. This parameter is used to configure the type of transport channel used to exchange APS protocol messages. Valid values are as follows: –DCC - APS messages are transmitted over the data communications channels (DCCs) in the overhead of the associated channels. –OSC - APS messages are transmitted over the OSC (optical supervisory channel). –AUTO - APS automatically selects a transport mechanism to send APS messages. The DCC and OSC transport mechanisms are attempted. –IP - APS messages are transmitted over IP. The IP network can consist of any combination of DCCs, OSCs and out-of-band data communication networks. The default is AUTO. •<msgholdtm> is the APS message channel holddown timer. This parameter specifies the minimum time between successive event-triggered APS messages, in units of milliseconds. The range is 100 to 10,000 milliseconds. The default is 5000 milliseconds. •<msgholdcount> is the APS channel message holddown count. This parameter is specifies the maximum number of APS messages that can be sent within one MSGHOLDTM interval. The range is 2 to 10 messages. The default is 2 messages. •<msgmaxintvtm> is the APS channel message maximum interval timer. An APS message is sent unconditionally, whenever the interval specified has elapsed since the last transmission of an APS message. The range is 1 to 120 seconds. The default is 15 seconds. •<fendprotid> is the far-end protection ID. This parameter is a case-sensitive string specifying the APS group at the far-end NE to which the message is being sent over DCC, IP, or OSC message channels. •<fendipaddr> is the far-end IP Address. This parameter is specifies the IP address of the far-end NE, which is used as destination address when APS messages are transmitted over IP message channel. •<pst> is the primary state, used to administratively control the state of the interface, whether it is IS (in-service) or OOS (out-of-service). It also controls the state of the laser on this interface. The default value is IS. When an interface is administratively shut down, the laser on the interface still sends management and control information. The laser needs to be shut down explicitly. To shut down the interface alone, use OOS-MA as the PST value. To shut down the laser as well, use the PST value of OOS-MA and SST value of LASERSHUT.
Input Example	To enable a previously configured APS group, use the following: ED-FFP-OCH:ons155xx:WAVEPATCH-2-0-0,WAVEPATCH-2-0-1:123:::: IS;
Errors	Errors are listed in Table 2-15.

3.19 ED-GBE10: Edit 10-Gbps

CDL provides OAM&P (operation, administration, maintenance and provisioning) in Ethernet packet-based optical networks without a SONET/SDH layer.


Section	ED-GBE10 Description
Category	Interface configuration-10 GE
Security	Provisioning
Related Messages	RTRV-GBE10: Retrieve 10-Gbps Interfaces
Input Format	ED-GBE10:[<tid>]:<aid>:<ctag>:::[CDL=<cdl>],[FLC=<flc>], [FRCENDHOP=<frcendhop>], [THRLISTNAME=<thrlistname>]:[<pst>]; Where: •<tid> is the target identifier. •<aid> identifies the waveetherphy, tengigetherphy, or wavepatch interface being configured. Valid interface values are WAVEETHERPHY-slot-0, TENGIGETHERPHY-slot-0, or WAVEPATCH-slot-0-port. •<cdl> enables or disables the CDL on the given interface. Applicable only on the TENGIGETHERPHY-slot-0 and WAVEETHERPHY-slot-0 AIDs. When CDL is enabled on a tengigetherphy interface, an etherdcc interface is created with AID of ETHERDCC-slot-0-1. Valid values are Y or N. The default value is N. •<flc> enables or disables forward laser control on TENGIGETHERPHY-slot-0 and WAVEETHERPHY-slot-0 AIDs. If forward laser control is enabled, the transmit laser is shut when the cross-connect receive port on the switch is in alarm condition. Valid values are Y or N. The default is N. •<frcendhop> enables or disables the CDL end-of-hop behavior on the given interface. Valid values are Y or N. Default value is N. The CDL node behavior defines how defect indications are handled. A node behaving as end-of-hop terminates hop-by-hop defect indications. This configuration is valid only when APS is not configured on the interface. If APS is configured, the node behaves as end-of-hop regardless of this object setting. If APS is not configured, we recommend forcing the end-of-hop behavior at administrative boundaries. This ensures that FDI-H and BDI-H between two admin domains reflects only errors that occur between the domains.This parameter can only be used with aid waveetherphy-slot-0. •<thrlistname> assign a threshold list name to a TENGIGETHERPHY-slot-0 or WAVEETHERPHY-slot-0 AID. The operator associates multiple threshold lists with an interface. To remove a threshold list from an interface, a NULL value should be passed for that particular list, using the ED-GBE10 command. •<pst> administratively controls the state of the interface, whether it is IS (in-service) or OOS (out-of-service). It also controls the state of the laser on this interface. The default value is IS. When an interface is administratively shut down, the laser on the interface still sends management and control information. The laser needs to be shut down explicitly. To shut down the interface alone, the PST value of OOS-MA should be used. To shut down the laser as well, the PST value of OOS-MA and SST value of LASERSHUT should be used.
Input Example	To force end-of-hop behavior on the waveetherphy interface in slot 9, use the following: ED-GBE10:ons155xx:WAVEETHERPHY-9-0:123:::FRCENDHOP=Y;
Errors	Errors are listed in Table 2-15.

3.20 ED-IP: Edit IP

Use this command to edit the IP address and mask on the network management Ethernet port or the OSC wave interface.

Note This command cannot be used to change an unnumbered interface configuration. To modify an unnumbered interface configuration, delete the existing configuration using the DLT-IP command and reconfigure using the ENT-IP command.


Section	ED-IP Description
Category	IP configuration
Security	Retrieve
Related Messages	DLT-IP: Delete IP DLT-IPROUTE-STATIC: Delete IP Route Static ENT-IP: Enter IP RTRV-IP: Retrieve IP RTRV-IPROUTE: Retrieve IP Route SQUEEZE-MEM: Squeeze Memory
Input Format	ED-IP:[<tid>]:<aid>:<ctag>:::IPADDR=<addr>,IPMASK=<mask>; Where: •<tid> is the target identifier. •<aid> is the access identifier. Valid values are FE-0, SBY-FE-0, or WAVE-slot-subcard. •<ctag> is the correlation tag. •<addr> is the IP address. •<mask> is the IP mask.
Input Example	Assuming that an IP address was previously configured on the FE-0 interface, to change the address and mask values, use the following: ED-IP:ons155xx:FE-0:123:::IPADDR=172.16.30.10, IPMASK=255.255.0.0;
Errors	Errors are listed in Table 2-15.

3.21 ED-NE-CDP: Edit Network Element CDP


Section	ED-NE-CDP Description
Category	CDP
Security	Provisioning
Related Messages	RTRV-NE-CDP: Retrieve Network Element CDP
Input Format	ED-NE-CDP:[<tid>]::<ctag>:::[CDP=<cdp>],[UPDATETIME=<updatetime>], [HOLDTIME=<holdtime>],[SENDVER=<sendver>]; Where: •<tid> is the target identifier. •<ctag> is the correlation tag. •<cdp> enables or disables CDP at the NE level. Valid values are Y or N. By default CDP is enabled. •<updatetime> specifies how often the NE sends CDP packets. Valid values range from 5 to 254 seconds. The default value is 60 seconds. •<holdtime> sets the time for which a received CDP packet must be held before discarding. Valid values range from 10 to 255 seconds. The default value is 180 seconds. Note The holdtime should not be set to a value less than the updatetime value. •<sendver> indicates the highest version of CDP packets being sent. Valid values are one or two. If SENDVER is two, then both CDP version 1 and version 2 are being sent by this NE. If SENDVER is 1, then only CDP version 1 packets are being sent by this NE. By default, sendver is 2.
Input Example	To edit CDP attributes for the entire system, use the following: ED-NE-CDP:ons155xx::123::UPDATETIME=30,HOLDTIME=90;
Errors	Errors are listed in Table 2-15.

3.22 ED-NE-GEN: Edit Network Element General

3.23 ED-NE-OSCP: Edit Network Element OSCP


Section	ED-NE-OSCP Description
Category	OSCP
Security	Provisioning
Related Messages	RTRV-NE-OSCP: Retrieve Network Element OSCP
Input Format	ED-NE-OSCP:[<tid>]::<ctag>:::[HELLOINTV=<hello_intv>], [HELLOHLDWN=<hldwn_time>],[INACTFCTR=<factor>]; Where: •<tid> is the target identifier. •<ctag> is the correlation tag. •<hello_intv> is the hello interval. It is the time between successive hello packets in milliseconds. Valid values range from 100 to 10,000 milliseconds The default value is 200 milliseconds. •<hldwn_time> is the hello hold down timer. It is the time interval for which no more than one hello packet can be sent. Valid values range from 150 to 30,000 milliseconds. The default value is 3000 milliseconds. •<factor> is the inactivity factor. It is the number of hello intervals to wait before declaring a link as down. Valid values range from 1 to 150. The default value is 5.
Input Example	To configure OSCP protocol parameters, use the following: ED-NE-OSCP:ons155xx::123:::HELLOINTV=500,HELLOHLDWN=200, INACTFCTR=10;
Errors	Errors are listed in Table 2-15.

3.24 ED-OCH: Edit Optical Channel

Use this command to configure a Layer 1 protocol encapsulation on the transparent interface specified in the AID field.


Section	ED-OCH Description
Category	Transparent interface configuration
Security	Provisioning
Related Messages	RTRV-OCH: Retrieve Optical Channel OPR-LPBK-OCH: Operate Loopback OCH RTRV-OCH: Retrieve Optical Channel
Input Format	ED-OCH:[<tid>]:<aid>:<ctag>:::[ENCAP=<encap>],[RATE=<rate>], [FLC=<flc>], [LSC=<lsc>],[OFC=<ofc>],[THRLISTNAME=<name>], [CDP=<cdp>],[LASERFREQ=<laserfreq>]:[<pst>]; Where: •<tid> is the target identifier. •<aid> indicates the interface configured. Valid values of AID are TRANSPARENT-slot-0-0, WAVE-slot-0, WAVEPATCH-slot-0-port, WAVEETHERPHY-slot-0, or ETHERDCC-slot-0-0. •<encap> indicates the protocol encapsulation configured on the transparent interface only. Valid values are as follows: –OC3 –OC12 –OC48 –STM1 –STM4 –STM16 –ESCON –FE –FDDI –FICON-1G –FICON-2G –FC-1G –FC-2G –SYSPLEX-CLO –SYSPLEX-ETR –SYSPLEX-ISC-COMP –SYSPLEX-ISC-PEER –GIGE –TENGIGE –UNKNOWN Note The default value is unknown. This parameter can be modified only when the interface is in the OOS state or when it is being brought down to OOS state in the same command. •<rate> indicates the clock rate being configured on an interface. This parameter is configured only when the encapsulation is set to UNKNOWN.
Input Format	•<flc> enables and disables forward laser control. If forward laser control is enabled, the transmit laser is shut down when the cross connect receive port on the switch is in alarm condition. Valid values are Y or N, where N is the default. •<lsc> enables or disables laser safety control. The LSC parameter can be configured on wave interfaces only when the carrier boards have no optical splitter. If laser safety control is enabled, the transmit laser on the trunk side is shut down when the receive signal is not available on the fiber. Valid values are Y or N. The default value is N. •<ofc> enables or disables the OFC (open fibre control) safety protocol. The OFC parameter can be modified only when the encapsulation is FC-1G, FC-2G, or FICON and applies to transparent interfaces only. Valid values are Y or N. The default value is N. •<thrlistname> refers to the name entered using the ENT-THR-OCH command. The threshold list sets thresholds for errors monitored on this interface. The ampersand (&) operator associates multiple threshold lists with an interface. To delete a threshold list from an interface, a null value should be passed for that particular list, using the ED-OCH command. •<cdp> enables or disables CDP (Cisco Discovery Protocol) on this port. It applies to the WAVE-slot-subcard (OSC) and ETHERDCC ports only. Valid value are Y or N. The default is Y. •<laserfreq> specifies the transmit frequency for line cards capable of generating more than one laser frequency. The frequency is represented in GHz. This parameter applies to WAVE-slot-0 and WAVEETHERPHY-slot-0 interfaces and can be modified only when the interface is in the OOS (out-of-service) state or when it is brought down to OOS state with the same command. The default is the lower frequency for the line card. •<pst> is the primary state. The value set in this state determines if the interface is shut down or active. IS (in-service) renders the interface administratively up. OOS is used to administratively shut down the interface. The default value is OOS.
Input Example	To configure OC-12 service on the transparent interface in slot 3, enable FLC, and associate the threshold list named "sonet-cvs", using the following command: ED-OCH:ons155xx:TRANSPARENT-3-0-0:123:::ENCAP=OC12,FLC=Y, THRLISTNAME=sonet-cvs; To configure wave interface in slot 2 with FLC and LSC enabled, use the following: ED-OCH:ons155xx:WAVE-2-0:123:::THRLISTNAME=sonet-cvs,FLC=Y, LSC=Y, LASERFREQ=159800; To configure an unknown protocol with a rate of 125,000 Kbps on transparent interface in slot 2, use the following: ED-OCH:ons155xx:TRANSPARENT-2-0-0:123:::ENCAP=UNKNOWN, RATE=125000; To enable or disable OFC safety protocol on a transparent interface in slot 2, use the following: ED-OCH:ons155xx:TRANSPARENT-2-0-0:123:::ENCAP=FC-1G,OFC=Y;
Errors	Errors are listed in Table 2-15.

3.25 ED-PID: Edit Password


Section	ED-PID Description
Category	Security
Security	Provisioning
Related Messages	ACT-USER: Activate User
Input Format	ED-PID:[<tid>]:<uid>:<ctag>::<oldpid>,<newpid>; Where: •<tid> is the target identifier. •<uid> is the user identifier, a string value with a maximum size of 64 characters. •<ctag> is the correlation tag. •<oldpid> is the old password, which is a string with a maximum size of 25 characters. •<newpid> is the new user login password which is a string with a maximum size of 25 characters.
Input Example	To edit your own password, use the following: ED-PID:ons155xx:admin:123::mypswd,newpswd;
Errors	Errors are listed in Table 2-15.

3.26 ED-THR-OCH: Edit Thresholds OCH


Section	ED-THR-OCH Description
Category	Threshold list configuration
Security	Retrieve
Related Messages	RTRV-THR-OCH: Retrieve Thresholds OCH SET-TH-rr: Set Optical Threshold
Input Format	ED-THR-OCH:[<tid>]:<THRLISTNAME>:<ctag>:::ERRTYPE=<errtype>, THRTYPE=<thrtype>, [VALUE=<value>], [TRGAPS=<trgaps>], [DESCR=<descr>]; where: •<tid> is the target identifier. •<thrlistname> indicates the name of the threshold list being edited. •<ctag> is the correlation tag. •<errtype> indicates the type of error counter to which the threshold applies. Possible values are as follows: –CVS - SONET section CV errors –CVRD - 8B/10B code violations and running disparity errors –CDLHEC - CDL HEC errors –CRC - Cyclic redundancy check errors •<thrtype> indicates the threshold type. Valid values are as follows: –DEGR - Indicates that a signal degrade condition has been reached. Use this threshold type only when <errtype> is CVS. –FAIL -Indicate that a signal failure condition has been reached. Use this threshold type only when <errtype> is CVS. –EVTTHR - Indicates that a non-service affecting condition has been reached. Use this threshold type when <errtype> is not CVS. –ALMTHR - Indicates that a service affecting condition has been reached. Use this threshold type when <errtype> is not CVS. •<value> specifies the threshold. If the value assigned here is x, the actual threshold is in the form of 10^-x. •<trgaps> enables a trigger for optical protection switchovers when the threshold exceeding. Valid values are Y or N. The default value is Y when ERRTYPE is CVS and N for all other ERRTYPE values. •<index> is an integer value used to uniquely identify a particular threshold within a list of thresholds. The range is 1 to 64. When no value is specified for this parameter, the index for the threshold being created defaults to the lowest available index in that threshold list. •<descr> is a string used to assign a description to the threshold that is being configured. The maximum length of this string is 255 characters.
Input Example	To edit the parameters for an existing threshold in a list, use the following: ED-THR-OCH:ons155xx:sonet-cvs:123:::ERRTYPE=CVS,THRTYPE=DEG, VALUE=5;
Errors	Errors are listed in Table 2-15.

3.27 ED-USER-SECU: Edit User Security

Use this command to edit the user identifier, password, or privilege levels associated with a user.


Section	ED-USER-SECU Description
Category	Threshold list configuration
Security	Retrieve
Related Messages	ACT-USER: Activate User DLT-USER-SECU: Delete User Security ENT-USER-SECU: Enter User Security RTRV-USER-SECU: Retrieve User Security
Input Format	[<tid>]:<uid>:<ctag>::<newuid>,<newpid>,,<uap>; Where: •<tid> is the target identifier. •<uid> user identifier, a string value with a maximum size of 64 characters. •<ctag> is the correlation tag. •<newuid> is the new value of the user identifier. It replaces the old value indicated by the <uid>. This field has the same semantics as the <uid> field. •<uap> is the user access privilege level. Valid values are as follows: –MAINT - maintenance level –PROV - provisioning level –RTRV - retrieve level –SUPER - superuser level
Input Example	To edit the user identifier, password, or privilege levels associated with a user, use the following: ED-USER-SECU:ons155xx:admin:123::sonalm,password,,PROV;
Errors	Errors are listed in Table 2-15.

3.28 ENT-CRS-OCH: Enter Cross Connects

Use this command to create electrical cross connects between line cards across the switch fabric.


Section	ENT-CRS-OCH Description
Category	Cross connects
Security	Retrieve
Related Messages	DLT-CRS-OCH: Delete Cross Connects RTRV-CRS-ALL: Retrieve Cross Connects All RTRV-CRS-OCH: Retrieve Cross Connects OCH
Input Format	ENT-CRS-OCH:[<tid>]:<from_aid>,<to_aid>:<ctag>::[<cct>]; Where: •<tid> is the target identifier. •<from_aid> identifies the from port of the cross connect. The valid value is PORTGROUP-slot-0-port. •<to_aid> identifies the to port of the cross connect. Valid values are WAVEETHERPHY-slot-0, WAVEETHERPHY-slot-0-subint, and TENGIGETHERPHY-slot-0-subint. •<cct> identifies the type of cross connect. Valid values are 1WAY or 2WAY. The default is 2WAY.
Input Example	To create an electrical cross connect between the portgroup interface in slot 1 and the waveetherphy subinterface on the card in slot 7, use the following: ENT-CRS-OCH:ons155xx:PORTGROUP-1-0-0,WAVEETHERPHY-7-0-1:123;
Errors	Errors are listed in Table 2-15.

3.29 ENT-FFP-OCH: Enter Optical Protection

Use this command to configure splitter protection, line card protection, and trunk fiber based protection.


Section	ENT-FFP-OCH Description
Category	APS
Security	Retrieve
Related Messages	DLT-FFP-OCH: Delete Facility Protection OCH RTRV-FFP-OCH: Retrieve Facility Protection OCH
Input Format	ENT-FFP-OCH:[<tid>]:<wkg_aid>,<prot_aid>:<ctag>:::[PROTID=<protid>], [PSDIRN=<psdirn>], [RVRTV=<rvrtv>],[RVRTM=<rvrtm>], [YCABLE=<ycable>],[ENSWOTM=<enswotm>], [MSGCH=<msgch>],[MSGHOLDTM=<msgholdtm>], [MSGHOLDCOUNT=<msgholdcount>], [MSGMAXINTVTM=<msgmaxintvtm>], [FENDPROTID=<fendprotid>], [FENDIPADDR=<fendipaddr>]: [<pst>]; Where: •<tid> is the target identifier. •<wkg_aid> is the working port AID. For splitter protection, the AID is in the form WAVEPATCH-slot-0-port, where port equals 0 or 1. For y-cable protection, the AID is of the form TRANSPARENT-slot-0-0. For trunk fiber based protection, the AID is WDMSPLIT-0-subcard-port, where port is 0 or 1. •<prot_aid> is the protection port AID. For splitter protection, the AID is in the form WAVEPATCH-slot-0-port, where port equals 0 or 1. For y-cable protection, the AID is of the form TRANSPARENT-slot-0-0. For trunk fiber based protection, the AID is WDMSPLIT-0-subcard-port, where port is 0 or 1. •<ctag> is the correlation tag. •<protid> is the protection group identifier or protection group name. The string can have a maximum of 32 characters. If <protid> is not specified, a protection group name is created with the name of the wkg_aid. •<psdirn> is the switching mode. Valid values are UNI (unidirectional) and BI (bidirectional). The default is UNI. •<rvrtv> is the revertive mode that applies only if monitoring in the standby state is supported. Valid values are Y or N. The default is N. If the value is Y, then the protection switching system reverts service to the active line after restoration. •<rvrtm> is the revertive timer that applies only if the mode is revertive and specifies the wait interval for revertive switching. The range is 0 to 720 seconds. The default is 300 seconds. •<ycable> specifies whether the type of protection is y-cable or not. Valid values are Y or N. The default is N. •<enswotm> specifies the switchover-enable timer. The timer delays re-enabling of auto-failover (to prevent rapid switching between standby and active states). The range is 1 to 120 seconds and the default is two seconds.
Input Format (continued)	•<msgch> specifies the APS message channel. This parameter configures the type of transport channel used to exchange APS protocol messages. The valid values are as follows: –DCC - APS messages are transmitted over the data communications channels (DCCs) in the overhead of the associated channels. –OSC - APS messages are transmitted over the optical supervisory channel. –AUTO - APS automatically selects a transport mechanism to send APS messages. The DCC and OSC are attempted. –IP - APS messages are transmitted over IP. The IP network can consist of any combination of DCCs, OSCs and out-of-band data communication networks. The default is AUTO. •<msgholdtm> specifies the APS message channel holddown time. This parameter specifies the minimum time between successive event-triggered APS messages in units of milliseconds. The range is 100 to 10000 milliseconds. The default is 5000 milliseconds. •<msgholdcount> specifies APS channel message holddown count. This parameter specifies the maximum number of APS messages that can be sent within one MSGHOLDTM interval. The range is 2 to 10 messages.The default is 2 messages. •<msgmaxintvtm> specifies the APS channel message maximum interval time. An APS message is sent unconditionally whenever the amount of time specified by this object has elapsed since the last transmission of an APS message. The range is 1 to 120 seconds. The default is 15. •<fendprotid> is the far-end protection identifier. This parameter is a case-sensitive string specifying the APS group at the far-end NE to which the message is being sent over DCC, IP, or OSC message channels. •<fendipaddr> specifies the far end IP address This parameter specifies the IP address of the far end, which is used as the destination address when APS messages are transmitted. •<PST> is the primary state.It sets the protection group to be in service or out of service, upon creation. Valid values are IS (in-service) and OOS (out-of-service). OOS-MA (OOS for maintenance) is implied. The default is IS.
Input Example	To configure splitter protection, use the following: ENT-FFP-OCH:ons155xx:WAVEPATCH-2-0-0,WAVEPATCH-2-0-1:123::: PROTID=switch1-aps,PSDIRN=BI:OOS; To configure y-cable protection, use the following: ENT-FFP-OCH:ons155xx:TRANSPARENT-3-0-0,TRANSPARENT-4-0-0::: PROTID=switch2-aps,RVRTV=Y,RVRTM=6,ENSWOTM=10,YCABLE=Y; To configure trunk fiber based protection, use the following: ENT-FFP-OCH:ons155xx:WDMSPLIT-0-1-0,WDMSPLIT-0-1-1::: PROTID=switch3-aps,PSDIRN=BI:IS; To configure switch fabric based protection, use the following: ENT-FFP-OCH:ons155xx:WAVEETHERPHY-1-0,WAVEETHERPHY-2-0::: PROTID=switch4-aps;
Errors	Errors are listed in Table 2-15.

3.30 ENT-IP: Enter IP

Use this command to configure the network management Ethernet port or the OSC interface.


Section	ENT-IP Description
Category	IP configuration
Security	Retrieve
Related Messages	DLT-IP: Delete IP DLT-IPROUTE-STATIC: Delete IP Route Static ED-IP: Edit IP ENT-IPROUTE-STATIC: Enter Static Routes RTRV-IP: Retrieve IP
Input Format	ENT-IP:[<tid>]:<aid>:<ctag>:::IPADDRTYPE=<addr_type>,[IPADDR=<addr>], [IPMASK=<mask>],[IPUNIF=<interface>]; Where: •<tid> is the target identifier. •<aid > is FE-0, FE-SBY-0, WAVE-slot-subslot, ETHERDCC-slot-0-0, or LOOPBACK-[0-255]. If the AID is LOOPBACK-port, then the loopback interface is created and the parameters are assigned to it. •<ctag> is the correlation tag. •<addr_type> specifies the address type. This parameter has one of the following values: –ADDR indicates that the IP address is specified. –UNMBR indicates that the unnumbered interface is specified. •<addr> indicates the IP address. This parameter is mandatory if IPADDRTYPE is set to ADDR. •<mask> indicates the IP address subnet mask and is mandatory if IPADDRTYPE is set to ADDR. •<interface> is the AID of the unnumbered interface and is mandatory if IPADDRTYPE is set to UNMBR. Applicable interfaces are as explained in the earlier <aid> description. Note If the unnumbered and LOOPBACK-0 combination is used, the AID can be only WAVE-slot-subslot or ETHERDCC-slot-0-0.
Input Example	To configure an IP address on a network management interface, use the following: ENT-IP:ons155xx:FE-0:123:::IPADDRTYPE=ADDR, IPADDR=172.16.42.110, IPMASK=255.255.255.0; To unnumber WAVE-1-0 to LOOPBACK-0 interface, use the following: ENT-IP:ons155xx:WAVE-1-0:123:::IPADDRTYPE=UNMBR, IPUNIF=LOOPBACK-0;
Errors	Errors are listed in Table 2-15.

3.31 ENT-IPROUTE-STATIC: Enter Static Routes


Section	ENT-IPROUTE-STATIC Description
Category	IP configuration
Security	Retrieve
Related Messages	DLT-IPROUTE-STATIC: Delete IP Route Static RTRV-IPROUTE: Retrieve IP Route
Input Format	ENT-IPROUTE-STATIC:[<tid>]::<ctag>:::PREFIXADDR=<addr>, PREFIXMASK=<mask>, [ROUTEIF=<interface>], [ROUTEADDR=<routeaddr>]; Where: •<tid> is the target identifier. •<ctag> is the correlation tag. •<addr> specifies the prefix IP address for the static route. •<mask> specifies the prefix mask. •<interface> specifies the AID of the routing interface. •<routeaddr > specifies the IP address of the routing interface Note At least one of the two parameters, ROUTEIF or ROUTEADDR, needs to be specified. There is no Edit command associated with the Enter command. If any of the parameters associated with the static route needs to be changed, the entire route needs to be deleted and a new route created.
Input Example	To configure a static route for a particular address through the OSC WAVE-1-0 port, use the following: ENT-IPROUTE-STATIC:ons155xx::123:::PREFIXADDR=10.1.0.0, PREFIXMASK=255.255.0.0, ROUTEIF=WAVE-1-0;
Errors	Errors are listed in Table 2-15.

3.32 ENT-NBR: Enter Neighbor


Section	ENT-NBR Description
Category	Topology neighbor configuration
Security	Provisioning
Related Messages	DLT-NBR: Delete Neighbor RTRV-NBR: Retrieve Neighbor
Input Format	ENT-NBR:[<tid>]:<aid>:<ctag>:::DSCVRY=<dscvry>, [LINKDIRN=<linkdirn>], [NBRNAME=<nbrname>], [NBRPORT=<nbrport>], [NBRAGENTIP=<nbragentip>], [PRXYPORT=<prxyport>]; Where: •<tid> is the target identifier. •<aid> identifies the interface and can be one of the following: –TRANSPARENT-slot-0-0 –TENGIGETHERPHY-slot-0 –WDM-slot-subcard –VOAOUT-slot-subcard-port •<dscvry> specifies the means of discovery of this neighbor. It could have one of the following values: –CDP - The neighbor information learned dynamically through CDP. –MANUAL - The neighbor information manually entered by the user. Note When CDP is specified, LINKDIRN defaults to both and other parameters should not be entered. •<linkdirn > is the link direction. Both transmit and receive links of this port are connected to the neighbor specified by the rest of the command. –TX - The neighbor is on the transmit link of this port. –RX - The neighbor is on the receive link of this port. For direct links between nodes, the LINKDIRN is both and there can be only one neighbor configured on the port. If an EDFA is connected to one direction of the port, there can be two neighbors, one configured for LINKDIRN = TX and the other for LINKDIRN = RX. •<nbrname> is the name of the neighbor NE. The string has a maximum 64 characters and is suggested that this be the <tid> of the neighbor NE. •<nbrport> is the name of the port on the neighbor NE. The string has a maximum 32 characters and is suggested that this be the <aid> of the port to which the local port is connected. •<nbragentip> is the IP address of the management agent on the neighbor. String has a maximum of 32 characters. •<prxyport> specifies the AID of the proxy port. This parameter is valid only when DSCVRY = CDP. In the case of external ports that do not run CDP on their own, but are intra-node connected to a port running CDP, then physical topology on the external port can be learned through CDP running on the proxy port specified through this parameter. Valid inputs are as follows: –WAVE-slot-subcard (the OSC wave interface) –ETHERNETDCC-slot-0-port
Input Example	To manually configure a physical neighbor on a port, use the following: ENT-NBR:ons155xx:WDM-0-0:123:::DSCVRY=MANUAL,LINKDIRN=RX, NBRNAME=shelf2,NBRPORT=WDM-0-0, NBRAGENTIP=172.16.20.1; To configure a physical neighbor enabling CDP on a port, use the following: ENT-NBR:ons155xx:WDM-0-0:100:::DSCVRY=CDP,PRXYPORT=WAVE-3-0;
Errors	Errors are listed in Table 2-15.

3.33 ENT-NTPASSOC: Enter NTP Associations

Use this command to configure NTP associations for synchronizing system clocks over the network. Two types of associations can be created:

•

Peer - The system synchronizes to a peer system and allows the peer to synchronize as well.

•

Server - The system synchronizes to the server, but not the other way around.

Note More than one association can be specified through multiple invocations of this command.


Section	ENT-NTPASSOC Description
Category	NTP
Security	Provisioning
Related Messages	DLT-NTPASSOC: Delete NTP Associations RTRV-NTPASSOC: Retrieve NTP Associations
Input Format	ENT-NTPASSOC:[<tid>]::<ctag>:::ASSOCTYPE=<assoctype>, ASSOCIPADDR=<associpaddr>; Where: •<tid> is the target identifier. •<ctag> is the correlation tag. •<assoctype> indicates the type of association. Valid values are SERVER and PEER. •<associpaddr> specifies the IP address of the server or peer.
Input Example	To configure an NTP server association, use the following: ENT-NTPASSOC:ons155xx::123:::ASSOCTYPE=SERVER, ASSOCIPADDR=172.16.5.5;
Errors	Errors are listed in Table 2-15.

3.34 ENT-PATCH: Enter Patch

Use this command to configure patches between ports on the same network element.


Section	ENT-PATCH Description
Category	Patch configuration
Security	Provisioning
Related Messages	DLT-PATCH: Delete Patch RTRV-PATCH: Retrieve Patch
Input Format	ENT-PATCH:[<tid>]:<from_aid>,<to_aid>:<ctag>::[<ctype>]; Where: •<tid> is the target identifier. •<from_aid> identifies the port you patched to the port identified by <to_aid>. Valid values for <from_aid> are as follows: –WDM-0-subcard –THRU-0-subcard –VOAFILTERIN-slot-subcard-0-subport –VOAFILTEROUT-slot-subcard-0-subport –VOABYPASSIN-slot-subcard-port –VOABYPASSOUT-slot-subcard-port –VOAIN-slot-subcard-port –VOAOUT-slot-subcard-port –OSCFILTER-0-subcard –FILTER-0-subcard-port –WAVE-slot-subcard –WAVEPATCH-slot-0-port. •<to_aid> identifies the port you patched from the port identified by <from_aid>. Valid values for <to_aid> are as follows: –WDM-0-subcard –THRU-0-subcard –VOAFILTERIN-slot-subcard-0-subport –VOAFILTEROUT-slot-subcard-0-subport –VOABYPASSIN-slot-subcard-0 –VOABYPASSOUT-slot-subcard-0 –VOAIN-slot-subcard-port –VOAOUT-slot-subcard-port –OSCFILTER-0-subcard –FILTER-0-subcard-port –WAVE-slot-subcard –WAVEPATCH-slot-0-port. •<ctag> is the correlation tag. •<ctype> is a position defined parameter and can be either 2WAY or 1WAY. When 1WAY is specified, then the patch is from the <from_aid> port to the <to_aid> port is either transmit or receive. 2WAY implies both transmit and receive patches between the two ports. The default is 2WAY
Input Example	To create a bidirectional patch between the wavepatch port in slot 2, port 0 and the filter port in slot 0, subslot 0, port 0, use the following: ENT-PATCH:ons155xx:WAVEPATCH-2-0-0,FILTER-0-0-0:123::;
Errors	Errors are listed in Table 2-15.

3.35 ENT-THR-OCH: Enter Thresholds OCH

Use this command to set thresholds for errors that are being monitored on an interface. This command is used every time a new threshold is added to a threshold list.


Section	ENT-THR-OCH Description
Category	Threshold list configuration
Security	Provisioning
Related Messages	DLT-THR-OCH: Delete Threshold OCH RTRV-THR-OCH: Retrieve Thresholds OCH RTRV-TH-rr: Retrieve Threshold SET-TH-rr: Set Optical Threshold
Input Format	ENT-THR-OCH:[<tid>]:<THRLISTNAME>:<ctag>:::ERRTYPE=<errtype>, THRTYPE=<thrtype>, VALUE=<value>, [TRGAPS=<trgaps>], [INDEX=<index>], [DESCR=<descr>]; Where: •<tid> is the target identifier. •<thrlistname> indicates the name of the threshold list being created. •<ctag> is the correlation tag. •<errtype> indicates the type of error counter to which the threshold applies. Possible values are as follows: –CVS - SONET section CV errors –CVRD - 8B/10B code violations and running disparity errors –CDLHEC - CDL HEC errors –CRC - Cyclic Redundancy Check errors •<thrtype> indicates the threshold type. Valid values are as follows: –DEGR - Indicates that a a signal degrade condition has been reached. Use this threshold type only when <errtype> is CVS. –FAIL - Indicates that a signal failure condition has been reached. Use this threshold type only when <errtype> is CVS. –EVTTHR - Indicates that a non-service affecting condition has been reached. Use this threshold type when <errtype> is not CVS. –ALMTHR - Indicates that a service affecting condition has been reached. Use this threshold type when <errtype> is not CVS. •<value> specifies the threshold value as 10^-x, where <value> is x. The range is 3 to 9. •<trgaps> is a trigger APS, such as protection switch on threshold exceeding. Valid values are Y or N. The default value is Y when ERRTYPE is CVS and is N for all other ERRTYPE values. •<index> is an integer value used to uniquely identify a particular threshold within a list of thresholds. The range is 1 to 64. When no value is specified for this parameter, the index for the threshold being created defaults to the lowest available index in that threshold list. •<descr> is a string used to assign a description to the threshold that is being configured. The maximum length of this string is 255 characters.
Input Example	To configure the SONET section CV threshold and add it to the threshold list sonet-cvs, use the command: ENT-THR-OCH:ons155xx:sonet-cvs:123:::ERRTYPE=CVS,THRTYPE=DEGR, VALUE=7, INDEX=1;
Errors	Errors are listed in Table 2-15.

3.36 ENT-USER-SECU: Enter User Security


Section	ENT-USER-SECU Description
Category	Security
Security	Retrieve
Related Messages	ACT-USER: Activate User CANC-USER: Cancel User DLT-USER-SECU: Delete User Security ED-USER-SECU: Edit User Security l RTRV-USER-SECU: Retrieve User Security
Input Format	ENT-USER-SECU:[<tid>]:<uid>:<ctag>::<pid>,,<uap>; Where: •<tid> is the target identifier. •<uid> is the user identifier, a string value with a maximum size of 64 characters. •<ctag> is the correlation tag. •<pid> is the user login password, a string value with a maximum size of 25 characters. •<uap> is the user access privilege level. Valid values are as follows: –MAINT - Maintenance level –PROV - Provisioning level –RTRV - Retrieve level –SUPER - Superuser level
Input Example	To create a user ID and set security parameters, use the following: ENT-USER-SECU:ons155xx:admin:123::psword,,PROV;
Errors	Errors are listed in Table 2-15.

3.37 FORMAT-MEM: Format Memory


Section	FORMAT-MEM Description
Category	Memory management
Security	Retrieve
Related Messages	CPY-MEM: Copy Memory l RST-MEM: Restore Memory RTRV-MEM: Retrieve Memory
Input Format	FORMAT-MEM:[<tid>]:<aid>:<ctag>:::[CMDMODE=<mode>]; Where: •<tid> is the target identifier. •<aid> indicates the memory device that is being formatted. Valid values are BOOTFLASH and SBY-BOOTFLASH. •<ctag> is the correlation tag. •<mode> indicates the mode of operation. Valid values are FRCD and NORMAL. In FRCD mode, any files that may be present on the Flash PC device, are permanently erased as part of the format operation. If any files are present on the Flash PC device in NORMAL mode, the format request is denied. The default mode is NORMAL.
Input Example	To permanently format a Flash PC device, use the following: FORMAT-MEM:ons155xx:BOOTFLASH:123:::CMDMODE=FRCD;
Errors	Errors are listed in Table 2-15.

3.38 INH-MSG-ALL: Inhibit Message All

3.39 INH-SWDX-EQPT: Inhibit Switch Duplex Equipment

Use this command to inhibit automatic or manual switching from the active to the standby CPU switch module. It also disables configuration syncs between the two CPU switch modules. This command is usually used when performing software upgrades.


Section	INH-SWDX-EQPT Description
Category	Redundancy configuration
Security	Maintenance
Related Messages	ALW-SWDX-EQPT: Allow Switch Duplex Equipment SW-DX-EQPT: Switch Duplex Equipment
Input Format	INH-SWDX-EQPT:[<tid>]:<aid>:<ctag>; Where: •<tid> is the target identifier. •<aid> is the access identifier. •<ctag> is the correlation tag.
Input Example	To inhibit automatic or manual switching from the active to the standby CPU switch module, or disable configuration syncs between the two CPU switch modules, use the following: INH-SWDX-EQPT:ons155xx:SLOT-6:123;
Errors	Errors are listed in Table 2-15.

3.40 INIT-REG-ESCON: Initialize Register ESCON

Use this command to clear the counters associated with a specific ESCON facility.


Section	INIT-REG-ESCON Description
Category	Threshold list configuration
Security	Maintenance
Related Messages	ED-ESCON: Edit ESCON RTRV-ESCON: Retrieve ESCON
Input Format	INIT-REG-ESCON:[<tid>]:<aid>:<ctag>; Where: •<tid> is the target identifier. •<aid> indicates the interface on which counters are being cleared. The value of the AID can be ESCON-slot-0-port. •<ctag> is the correlation tag.
Input Example	To clear the counters associated with the ESCON port in slot 2, port 2, use the following: INIT-REG-ESCON:ons155xx:ESCON-2-0-2:123;
Errors	Errors are listed in Table 2-15.

3.41 INIT-REG-ETH: Initialize Register Ethernet

Use this command to clear the counters associated with a specific Ethernet facility.


Section	INIT-REG-ETH Description
Category	IP configuration
Security	Retrieve
Related Messages	ED-IP: Edit IP RTRV-IP: Retrieve IP
Input Format	INIT-REG-ETH:[<tid>]:<aid>:<ctag>; Where: •<tid> is the target identifier. •<aid > indicates the interface where counters are being cleared. Valid values are FE-0 or FE-SBY-0. •<ctag> is the correlation tag.
Input Example	To clear the counters associated with a specific Ethernet facility, use the following: INIT-REG-ETH:ons155xx:FE-0:123;
Errors	Errors are listed in Table 2-15.

3.42 INIT-REG-GBE10: Initialize Register 10-Gbps

Use this command to clear the counters associated with a specific 10-Gbps facility.


Section	INIT-REG-GBE10 Description
Category	10-Gbps interface configuration
Security	Maintenance
Related Messages	RTRV-GBE10: Retrieve 10-Gbps Interfaces
Input Format	INIT-REG-GBE10:[<tid>]:<aid>:<ctag>; Where: •<tid> is the target identifier. •<aid> indicates the interface on which counters are being cleared. The value of AID can be WAVEETHERPHY-slot-0 or TENGIGETHERPHY-slot-0. •<ctag> is the correlation tag.
Input Example	To clear the counters associated with a 10-Gbps interface in slot 2, use the following: INIT-REG-GBE10:ons155xx:WAVEETHERPHY-2-0:123;
Errors	Errors are listed in Table 2-15.

3.43 INIT-REG-OCH: Initialize Register OCH


Section	INIT-REG-OCH Description
Category	Transparent and VOA interface configuration
Security	Maintenance
Related Messages	RTRV-OCH: Retrieve Optical Channel
Input Format	INIT-REG-OCH:[<tid>]:<aid>:<ctag>; Where: •<tid> is the target identifier. •<aid> indicates interface on which counters are being cleared. The value of AID can be TRANSPARENT-slot-0-0, WAVEETHERPHY-slot-0, or WAVE-slot-0. •<ctag> is the correlation tag.
Input Example	To clear the counters associated with transparent port in slot 2, use the following: INIT-REG-OCH:ons155xx:TRANSPARENT-2-0-0:123;
Errors	Errors are listed in Table 2-15.

3.44 INIT-SYS: Initialize System

3.45 OPR-LPBK-GBE10: Operate Loopback 10-Gbps

Use this command to operate a specific type of loopback on 10-Gbps ITU trunk card interfaces.


Section	OPR-LPBK-GBE10 Description
Category	10-Gbps interface configuration
Security	Maintenance
Related Messages	RLS-LPBK-GBE10: Release Loopback on the 10-Gbps
Input Format	OPR-LPBK-GBE10:[<tid>]:<aid>:<ctag>::,,,<lpbktype>; Where: •<tid> is the target identifier. •<aid> indicates the interface on which the loopback is being created. The value of AID can be WAVEETHERPHY-slot-0 or TENGIGETHERPHY-slot-0. •<lpbktype> indicates the type of loopback that is being created. Valid values are as follows: –FACILITY - The signal from the receive input is looped back to the transmit output. –TERMINAL - The signal bound for transmit output is looped back to the receive input. This is an internal loopback used for hardware debug and diagnostics.
Input Example	To create a facility loopback on the waveetherphy interface in slot 2, use the following: OPR-LPBK-GBE10:ons155xx:WAVEETHERPHY-2-0:123::,,,FACILITY;
Errors	Errors are listed in Table 2-15.

3.46 OPR-LPBK-OCH: Operate Loopback OCH

Use this command to operate a specific type of loopback on transponder line card interfaces.


Section	OPR-LPBK-OCH Description
Category	Transparent and VOA interface configuration
Security	Maintenance
Related Messages	RLS-LPBK-OCH: Release Loopback OCH
Input Format	OPR-LPBK-OCH:[<tid>]:<aid>:<ctag>::,,,<lpbktype>; Where: •<tid> is the target identifier. •<aid> indicates the interface on which the loopback is being created. The value of AID can be TRANSPARENT-slot-0-0 or WAVE-slot-0. •<ctag> is the correlation tag. •<lpbktype> indicates the type of loopback that is being created. Valid values are as follows: –FACILITY - The signal from the receive input is looped back to the transmit output.
Input Example	To create a facility loopback on the transparent interface in slot 2, use the following: OPR-LPBK-OCH:ons155xx:TRANSPARENT-2-0-0:123::,,,FACILITY;
Errors	Errors are listed in Table 2-15.

3.47 OPR-PROTNSW-OCH: Operate Protection Switch OCH


Section	OPR-PROTNSW-OCH Description
Category	APS
Security	Maintenance
Related Messages	RLS-PROTNSW-OCH: Release Protection Switch OCH
Input Format	OPR-PROTNSW-OCH:[<tid>]:<aid>:<ctag> Where: •<AID> is the working or protection port AID to which a switch request is directed. Thus, it can be a wavepatch interface or transparent interface. If the AID identifies the working line, then service is switched from working to protection. If the AID identifies the protection line, then service is switched back to the working line. •<SC> is the switch command. Valid values are as follows: –MAN - A switch from working or back to working is done based on the AID specified unless a request of equal or higher priority is in effect. –FRCD - A switch from working or back to working is done based on the AID specified unless a request of equal or higher priority is in effect. –LOCKOUT - A lockout of all switchovers to the protection facility. If the protection facility is currently active, then the lockout request is denied. The lockout request has the highest priority and takes effect regardless of signal condition. The forced switch command is of next highest priority. The manual switchover request has the lowest priority and only occur if there is no protection path lockout, a forced switchover, or the signal has failed or degraded.
Input Example	To enable the NE to perform a protection switch or a lockout, use the following: OPR-PROTNSW-OCH:ons155xx:WAVEPATCH-2-0-1:123::FRCD;
Errors	Errors are listed in Table 2-15.

3.48 RLS-LPBK-GBE10: Release Loopback on the 10-Gbps

Use this command to release a specific type of loopback on the port specified by the AID.


Section	RLS-LPBK-GBE10 Description
Category	10-Gbps interface configuration
Security	Maintenance
Related Messages	RTRV-GBE10: Retrieve 10-Gbps Interfaces
Input Format	RLS-LPBK-GBE10:[<tid>]:<aid>:<ctag>::,,,<lpbktype>; Where: •<tid> is the target identifier. •<aid> indicates the interface on which the loopback is being released. Valid values are WAVEETHERPHY-slot-0 or TENGIGETHERPHY-slot-0. •<ctag> is the correlation tag. •<lpbktype> indicates the type of loopback that is being released. Valid values are as follows: –FACILITY - The signal from the receive input loops back to the transmit output. –TERMINAL - The signal to the transmit output loops back to the receive input. This is an internal loopback used for hardware debugging and diagnostics
Input Example	To release a facility loopback on the waveetherphy interface in slot 2, use the following: RLS-LPBK-GBE10:ons155xx:WAVEETHERPHY-2-0:123::,,,FACILITY;
Errors	Errors are listed in Table 2-15.

3.49 RLS-LPBK-OCH: Release Loopback OCH

Use this command to release a specific type of loopback on the port specified by the AID.


Section	RLS-LPBK-OCH Description
Category	Transparent and VOA interface configuration
Security	Maintenance
Related Messages	OPR-LPBK-OCH: Operate Loopback OCH
Input Format	RLS-LPBK-OCH:[<tid>]:<aid>:<ctag>::,,,<lpbktype>; Where: •<tid> is the target identifier. •<aid> indicates the interface on which the loopback is being released. Valid values are TRANSPARENT-slot-0-0 or WAVE-slot-0. •<ctag> is the correlation tag. •<lpbktype> indicates the type of loopback that is being released. FACILITY is a valid value, where the signal from the receive input is looped back to the transmit output.
Input Example	To release a facility loopback on the transparent interface in slot 2, use RLS-LPBK-OCH:ons155xx:TRANSPARENT-2-0-0:123::,,,FACILITY;
Errors	Errors are listed in Table 2-15.

3.50 RLS-PROTNSW-OCH: Release Protection Switch OCH

Note A lockout or a forced or manual switchover request stays in effect until the system reboots.

3.51 RST-MEM: Restore Memory

Use this command to recover a file that was previously deleted, but not erased, using the DLT-MEM command.

Note A deleted file cannot be recovered if a valid one with the same name exists. The existing file needs to be deleted before the already deleted one can be recovered. If two files with the same name were deleted, the index is used to uniquely identify the file to be recovered.


Section	RST-MEM Description
Category	Memory Management
Security	Retrieve
Related Messages	CPY-MEM: Copy Memory FORMAT-MEM: Format Memory RTRV-MEM: Retrieve Memory
Input Format	RST-MEM:[<tid>]:<aid>:<ctag>:::INDEX=<index>; Where: •<tid> is the target identifier. •<aid> indicates the memory device from which the file is being recovered. Valid values are BOOTFLASH and SBY-BOOTFLASH. •<ctag> is the correlation tag. •<index> specifies the index number associated with the deleted file. This is an integer value and can be obtained by using the RTRV-MEM command.
Input Example	To recover a file that was previously deleted, but not erased, using the DLT-MEM command, use the following: RST-MEM:ons155xx:BOOTFLASH:123::INDEX=4;
Errors	Errors are listed in Table 2-15.

3.52 RST-NE-CDP: Restore Global CDP Attributes

Use this command to restore all global CDP attribute settings to their default values.

3.53 RTRV-ALM-ALL: Retrieve Alarms All

Note Only alarms with severities critical, major, or minor can be retrieved using this command.


Section	RTRV-ALM-ALL Description
Category	Alarms and faults
Security	Retrieve
Related Messages	ALW-MSG-ALL: Allow Message All
Input Format	RTRV-ALM-ALL:[<tid>]:[<aid>]:<ctag>::[<ntfcncde>]; Where: •<tid> is the target identifier. •<aid> is the access identifier. Valid values are SLOT-slot and SLOT-slot-subcard. •<ctag> is the correlation tag. •<ntfcncde> indicates the type of notification generated on the NE when a threshold is exceeded or cleared. Valid values are CR, MJ, or MN.
Input Example	To retrieve alarms for the transponder line card in slot 2, use the following: RTRV-ALM-ALL:ons155xx:SLOT-2-0:123::MJ; To retrieve alarms for the transparent interface in slot 2, use the following: RTRV-ALM-ALL:ons155xx:TRANSPARENT-2-0-0:123::MJ;
Output Format	SID DATE TIME M CTAG COMPLD "<aid>:<severity>,<alarm>,SA,,,,,:\"<text>\"" ;
Output Example	The output if no alarm condition exists: SID DATE TIME M 123 COMPLD ; The output if a matching alarm condition exists: SID DATE TIME M 123 COMPLD "TRANSPARENT-2-0-0:MJ,LOF,SA,,,,,:\"Loss Of Frame\"" ;
Errors	Errors are listed in Table 2-15.

3.54 RTRV-ALM-ENV: Retrieve Alarms Environmental


Section	RTRV-ALM-ENV Description
Category	Alarms and faults
Security	Retrieve
Related Messages	RTRV-ALM-ALL: Retrieve Alarms All
Input Format	RTRV-ALM-ENV:[<tid>]:[<aid>]:<ctag>::[<ntfcncde>]; Where: •<tid> is the target identifier. •<aid> is the access identifier. •<ctag> is the correlation tag. •<ntfcncde> indicates the type of notification generated on the NE when a threshold is exceeded or cleared. Valid values are CR, MJ, or MN.
Input Example	To retrieve major environmental alarms, use the following: RTRV-ALM-ENV:ons155xx::123::MJ;
Output Format	SID DATE TIME M CTAG COMPLD "<aid>:<severity>,<alarm>,SA,,,,,:\"<text>\"" ;
Output Example	The output if a matching alarm condition exists: SID DATE TIME M 123 COMPLD "Chassis:MJ,HITEMP,,,\"Chassis temperature too high\"" ;
Errors	Errors are listed in Table 2-15.

3.55 RTRV-ATTR-rr: Retrieve Attributes

Use this command to retrieve the severity levels assigned to the threshold values configured on the wavepatch interfaces, waveetherphy interfaces, voain interfaces, or voafilterin interfaces.


Section	RTRV-ATTR-rr Description
Category	Alarms and faults
Security	Retrieve
Related Messages	RST-NE-CDP: Restore Global CDP Attributes SET-ATTR-rr: Set Attributes
Input Format	[<tid>]:[<aid>]:<ctag>::[<ntfcncde>],[<condtype>],, [<dirn>]; Where rr can be OCH or WDM •<tid> is the target identifier. •<aid> indicates wavepatch, waveetherphy or voain interfaces on which the threshold is to be set. When rr is set to OCH, valid values are WAVEPATCH-slot-0-port or WAVEETHERPHY-slot-0. When rr is set to WDM, valid values are VOAIN-slot-subcard-port or VOAFILTERIN-slot-subcard-port. •<ctag> is the correlation tag. •<ntfcncde> is indicates the type of notification generated on the NE when a threshold is exceeded or cleared. Valid values are CR, MJ, or MN. •<condtype> is monitored condition type. Valid values are as follows: –OPRHA - Receive optical power level corresponding to the high alarm threshold. If the optical power level is greater than the threshold associated with this parameter, an alarm is generated. –OPRLA - Receive optical power level corresponding to the low alarm threshold. If the optical power level is less than the threshold associated with this parameter, an alarm is generated. –OPRHW - Receive optical power level corresponding to the high warning threshold. If the optical power level is greater than the threshold associated with this parameter, a warning is generated that may be reported using REPT EVT. –OPRLW - Receive optical power level corresponding to the low warning threshold. If the optical power level is less than the threshold associated with this parameter, a warning is generated that may be reported using REPT EVT. •<dirn> is the direction associated with the information. Valid values are RCV or TRMT. The default is both directions.
Input Example	To retrieve the severity levels assigned to the threshold values configured on wavepatch interfaces on the transponder cards, use the following: RTRV-ATTR-OCH:ons155xx:WAVEPATCH-8-0-0:123::,OPRHA; To retrieve the severity levels assigned to the threshold values configured on voafilterin interfaces on the transponder cards, use the following: RTRV-ATTR-WDM:ons155xx:VOAFILTERIN-8-0-0-0:123::,OPRHA;
Output Format	SID DATE TIME M CTAG COMPLD "<aid>:<severity>,<condtype>,,<dirn>" ;
Output Example	The output for wavepatch interfaces: SID DATE TIME M 123 COMPLD "WAVEPATCH-8-0-0:MJ,OPRHA,,RCV" ; The output for voafilterin interfaces: SID DATE TIME M 123 COMPLD "VOAFILTERIN-8-0-0-0:MJ,OPRHA,,RCV" ;
Errors	Errors are listed in Table 2-15.

3.56 RTRV-CDPNBR-OCH: Retrieve CDP Neighbor OCH

Use this command to retrieve neighbor information discovered by CDP on a specific port in the NE or on all ports of the NE.


Section	RTRV-CDPNBR-OCH Description
Category	CDP
Security	Retrieve
Related Messages	DLT-NBR: Delete Neighbor ENT-NBR: Enter Neighbor RTRV-NBR: Retrieve Neighbor
Input Format	RTRV-CDPNBR-OCH:[<tid>]:[<aid>]:<ctag>; Where: •<tid> is the target identifier. •<aid> specifies the port AID to retrieve information for the neighbor on that port only. NULL retrieves information on all neighbors. •<ctag> is the correlation tag.
Input Example	To retrieve neighbor information discovered by CDP on a specific port in the NE or on all ports of the NE, use the following: RTRV-CDPNBR-OCH:ons155xx::123;
Output Format	SID DATE TIME M CTAG COMPLD "<aid>:NBRNAME=<nbrname>,NBRPORT=<nbrport>, CAPABILITY=<capability>,TTL=<ttl>" ;
Output Example	SID DATE TIME M 123 COMPLD "WAVE-1-0:NBRNAME=Switch2,NBRPORT=PORT-0,CAPABILITY=S, TTL=158" ; Where: •<NBRNAME> indicates the name of the neighboring device, typically, the SID of that device. The maximum size is 255 characters. •<NBRPORT> is the name of the neighboring port. Typically, the AID of that port. •<CAPABILITY> indicates the capability of the neighboring device. It is a string formed by the concatenation of one or more of the following values: –R - Router, –T - Trans bridge –B - Source route bridge –S - Switch –H - Host –I - IGMP –r - Repeater •<TTL> is the time-to-live value. This is the amount of time in seconds before this neighbor information is discarded unless the NE receives another packet on this port with the same information.
Errors	Errors are listed in Table 2-15.

3.57 RTRV-COND-ALL: Retrieve Condition All

Use this command to retrieve current standing conditions associated with specified equipment or facility. This command retrieves conditions with all severities.


Section	RTRV-COND-ALL Description
Category	Alarms and faults
Security	Retrieve
Related Messages	RTRV-ALM-ALL: Retrieve Alarms All RTRV-ALM-ENV: Retrieve Alarms Environmental
Input Format	RTRV-COND-ALL:[<tid>]:[<aid>]:<ctag>; Where: •<tid> is the target identifier. •<aid> is the access identifier. •<ctag> is the correlation tag.
Input Example	To retrieve current standing conditions associated with specified equipment or facility, use the following: RTRV-COND-ALL:ons155xx:TRANSPARENT-8-0-0:123::;
Output Format	SID DATE TIME M CTAG COMPLD "<aid>,<encap>:<severity>,<condtype>,NSA,,,,,\"<text>\"" ;
Output Example	The output for conditions on the transparent interface: SID DATE TIME M 123 COMPLD "TRANSPARENT-8-0-0,OC3:MN,CVS,NSA, ,,,,\"Code Violation- Section - Exceed Degrade\"" ;
Errors	Errors are listed in Table 2-15.

3.58 RTRV-CRS-ALL: Retrieve Cross Connects All

Use this command to retrieve information on all existing cross connects on the device.


Section	RTRV-CRS-ALL Description
Category	Cross connects
Security	Retrieve
Related Messages	ENT-CRS-OCH: Enter Cross Connects RTRV-CRS-OCH: Retrieve Cross Connects OCH
Input Format	RTRV-CRS-ALL:[<tid>]::<ctag>; Where: •<tid> is the target identifier. •<ctag> is the correlation tag.
Input Example	To retrieve the existing cross connects, use the following: RTRV-CRS-ALL:ons155xx::123;
Output Format	SID DATE TIME M CTAG COMPLD "<from_aid>,<to_aid>:<dirn>" ;
Output Example	SID DATE TIME M 123 COMPLD "PORTGROUP-1-0-0,WAVEETHERPHY-7-0-1:2WAY" ;
Errors	Errors are listed in Table 2-15.

3.59 RTRV-CRS-OCH: Retrieve Cross Connects OCH

Use this command to retrieve the optical channel cross connects for specific AIDs.


Section	RTRV-CRS-OCH Description
Category	Cross connects
Security	Retrieve
Related Messages	ENT-CRS-OCH: Enter Cross Connects RTRV-CRS-ALL: Retrieve Cross Connects All
Input Format	RTRV-CRS-OCH:[<tid>]:<from_aid>,<to_aid>:<ctag>; Where: •<tid> is the target identifier. •<from_aid> identifies the from port of the cross connect. The valid value is PORTGROUP-slot-0-port. •<to_aid> identifies the to port of the cross connect. Valid values are WAVEETHERPHY-slot-0, WAVEETHERPHY-slot-0-subint, and TENGIGETHERPHY-slot-0-subint. •<ctag> is the correlation tag.
Input Example	To retrieve the OCH cross connects for specific AIDs, use the following: RTRV-CRS-OCH:ons155xx:PORTGROUP-1-0-0,WAVEETHERPHY-7-0-1:123;
Output Format	SID DATE TIME M CTAG COMPLD "<from_aid>,<to_aid>:<dirn>" ;
Output Example	SID DATE TIME M 123 COMPLD "PORTGROUP-1-0-0,WAVEETHERPHY-7-0-1:2WAY" ;
Errors	Errors are listed in Table 2-15.

3.60 RTRV-EQPT: Retrieve Equipment

Use this command to retrieve the redundancy configurations. It also retrieves inventory information for the specified module.

The PST and SST values in the last position defined block also indicate the redundancy states, when the AID specified in this command is SLOT-5 or SLOT-6. The values of PST-PSTQ and SST are reported under different operating conditions.

•

If standby is in fault state, PST=IS-ANR, SST=FLT, STBYC or STBYH (depending on software redundancy state.)

Under maintenance mode (when an INH-SWDX command has been issued for standby CPU switch module):

•

If hardware state is non-participant and software redundancy state is disabled, PST=OOS-AURST, SST=AINS,STBYI.

For all other software redundancy states like not known, negotiating, or StandbyCold, PST=IS-RST, SST=STBYI.

In addition to these values, two newly defined SST values indicate the synchronization status on the running and startup configurations.


Section	RTRV-EQPT Description
Category	Redundancy configuration
Security	Retrieve
Related Messages	INH-SWDX-EQPT: Inhibit Switch Duplex Equipment SW-DX-EQPT: Switch Duplex Equipment
Input Format	RTRV-EQPT:[<tid>]:[<aid>]:<ctag>; Where: •<tid> is the target identifier. •<aid> is the access identifier. The value is SLOT-slot. The default is all AIDs. •<ctag> is the correlation tag.
Input Example	To retrieve inventory information for a CPU switch module in slot 6, use the following: RTRV-EQPT:ons155xx:SLOT-6:123; To retrieve inventory information for a transponder card in slot 8, use the following: RTRV-EQPT:ons155xx:SLOT-8:123;
Output Format	Output format for CPU switch modules: SID DATE TIME M CTAG COMPLD "<aid>:<clei>:PN=<pn>,SN=<sn>,OPN=<opn>,HWVER=<hwver>, SWVER=<swver>,FWVER=<fwver>,BOOTLDR=<bootldr>, ROMMONVER=<rommonver>,HWREDSTATE=<hwredstate>, SWREDSTATE=<swredstate>,,:<pst>,<sst>,<sst>" ; Output format for transponder line cards and 2.5-Gbps ITU trun k cards: SID DATE TIME M CTAG COMPLD "<aid>:<clei>:PN=<pn>,SN=<sn>,OPN=<opn>,HWVER=<hwver>,, FSWVER=<fwver>,,,,,LASERFREQLOW=<laserfreqlow>, LASERFREQHIGH=<laserfreqhigh>:<pst>,<sst>,<sst>" ;
Output Example	SID DATE TIME M 123 COMPLD "SLOT-6:<CLEI>:PN=73-5656-03,SN=CAB0516HK2,OPN=N/A, HWVER=2.0,SWVER=12.1,FWVER=1.24, BOOTLDR=12.1(7a)EY2,ROMMONVER=12.1(7r)EY, HWREDSTATE=ACT,SWREDSTATE=ACT :IS-NR,NRCSYNC,NSCSYNC" ; Where: •PN is a string that shows shows the part number, maximum length is 32 characters. •SN is a string that shows the serial number, maximum length is 32 characters. •OPN is a string that shows the orderable product number, maximum length is 32 characters. •HWVER is a string that shows the hardware version number, maximum length is 32 characters. •SWVER is a string that shows the image version running on this CPU switch module, maximum length is 32 characters •FWVER is a string that shows the functional software image version running on the CPU switch module, maximum length is 32 characters. •BOOTLDR is a string that shows the bootloader image version, maximum length is 32 characters. This parameter is applicable to CPU switch module cards only. •ROMMONVER is a string that shows the ROMMON version and has a maximum length of 32 characters. This parameter is applicable to CPU switch modules only. •SWREDSTATE is the software redundancy state. This parameter is applicable to CPU switch modules only. Valid values are as follows: –NK - Not known –DSBL - Disabled –INIT - Initialization –SBYC - StandbyCold –SBYCC - StandbyColdConfig –SBYCF - StandbyColdFilesys –SBYCB - StandbyColdBulk –SBYH - StandbyHot –ACTF - ActiveFast –ACTD - ActiveDrain –ACTPR - ActivePreConfig –ACTPS - ActivePostConfig –ACT - Active
Output Example (continued)	•HWREDSTATE is the hardware redundancy state. This parameter is applicable to CPU switch module only. Valid values are as follows: –NP - Non-participant –ACT - Active –SBY - Standby –MISS - Missing –ERR - Errored To retrieve inventory information for a transponder line card in slot 8: SID DATE TIME M 123 COMPLD "SLOT-8:CLEI:PN=73-5656-03,SN=CAB0516HK2,OPN=N/A,HWVER=2.0, SWVER=12.1,FWVER=1.89,LASERFREQLOW=194500, LASERFREQHIGH=198500:IS-NR,," ; Where: •LASERFREQLOW indicates the lower ITU grid laser frequency that this card is capable of generating. This parameter applies only to transponder cards that are capable of generating one or more laser frequencies. •LASERFREQHIGH indicates the higher ITU grid laser frequency that this card is capable of generating. This parameter applies only to transponder cards that are capable of generating one or more laser frequencies.
Errors	Errors are listed in Table 2-15.

3.61 RTRV-ESCON: Retrieve ESCON

The PST and SST values in the last position defined block indicates the current status of the interface. The values of PST-PSTQ and SST, under different conditions, are listed as follows:

•

If the interface is administratively shut down by using the ENT-OCH command, values returned are PST=OOS-MA, SST=MT.

•

If the interface is down because of alarms on the link, like Loss of Signal/Loss of Frame, Loss of Light, values returned are PST=OOS-AU, SST=FAF.

•

If the interface is down because of alarms and is also administratively shut down, values returned are PST=OOS-AUMA, SST=FAF, MT.

•

If there is an entity failure on the NE, because the interface is down, values returned are PST=OOS-AU, SST= SGEO.

•

If only thresholds are being exceeded on the interface, values returned are PST=IS-ANR.


Section	RTRV-ESCON Description
Category	ESCON interface configuration
Security	Retrieve
Related Messages	ED-ESCON: Edit ESCON INIT-REG-ESCON: Initialize Register ESCON
Input Format	RTRV-ESCON:[<tid>]:[<aid>]:<ctag>; Where: •<tid> is the target identifier. •<aid> is the access identifier. The value is ESCON-slot-0-port. •<ctag> is the correlation tag.
Output Format	SID DATE TIME M CTAG COMPLD "<aid>:RXFLOWID=<rxflowid>,TXFLOWID=<txflowid>, THRLISTNAME=<thrlistname>,RXMAXFLOWID=<rxmaxflowid>, TXMAXFLOWID=<txmaxflowid>:<pst>" ;
Output Example	SID DATE TIME M 123 COMPLD "ESCON-2-0-0:RXFLOWID=9,TXFLOWID=9,THRLISTNAME=escon-thr, RXMAXFLOWID=254,TXMAXFLOWID=254:IS-NR" ; Where: •<RXMAXFLOWID> identifies the maximum value that can be assigned to the CDL flow identifier for a packet received on this interface. •<TXMAXFLOWID> identifies the maximum value that can be assigned to the CDL flow identifier for a packet transmitted on this interface.
Errors	Errors are listed in Table 2-15.

3.62 RTRV-FFP-OCH: Retrieve Facility Protection OCH


Section	RTRV-FFP-OCH Description
Category	APS
Security	Retrieve
Related Messages	DLT-FFP-OCH: Delete Facility Protection OCH ED-FFP-OCH: Edit Facility Protection
Input Format	RTRV-FFP-OCH:[<tid>]:[<wkg_aid>],[<prot_aid>]:<ctag>:::[PROTID=<protid>]; Where: •<tid> is the target identifier. •<wkg_aid> is the working port AID. Valid values are WAVEPATCH-slot-0-port, TRANSPARENT-slot-0-0, TENGIGETHERPHY-slot-0, or WDMSPLIT-0-subcard-port. •<prot_aid> is the protection port AID. Valid values are WAVEPATCH-slot-0-port, TRANSPARENT-slot-0-0, TENGIGETHERPHY-slot-0, or WDMSPLIT-0-subcard-port. •<ctag> is the correlation tag. •<protid> is the protection group identifier. It is a case-sensitive string and can have a maximum of 32 characters. If <protid> is not specified, a protection group name is created with the name of the <wkg_aid>.
Input Example	To retrieve optical facility protection information, use the following: RTRV-FFP-OCH:ons155xx:WAVEPATCH-2-0-0,WAVEPATCH-2-0-1:123;
Output Format	SID DATE TIME M CTAG COMPLD "<wkg_aid>,<prot_aid>:ACTIVE=<active>,STANDBY=<standby>, PROTID=<protid>,PSDIRN=<psdirn>,RVRTV=<rvrtv>,RVRTM=<rvrtm>, ENSWOTM=<enswotm>,SRCHUPMIN=<srchupmin>, SRCHUPMAX=<srchupmax>,FENDDIRN=<fenddirn>, MSGCH=<msgch>,MSGCHCUR=<msgchcur>, MSGHOLDTM=<msgholdtm>,MSGCHST=<msgchst>, MSGHOLDCOUNT=<msgholdcount>,MSGMAXTM=<msgmaxtm>:<pst>" ;
Output Example	SID DATE TIME M 123 COMPLD "WAVEPATCH-2-0-0,WAVEPATCH-2-0-1:ACTIVE=WAVEPATCH-2-0-0, STANDBY=WAVEPATCH-2-0-1,PROTID=switch1-aps,PSDIRN=BI, RVRTV=Y,RVRTM=300,ENSWOTM=10,SRCHUPMIN=2, SRCHUPMAX=32,FENDDIRN=UNI,MSGCH=AUTO,MSGCHCUR=DCC, MSGHOLDTM=1500,MSGCHST=IS,MSGHOLDCOUNT=2, MSGMAXTM=15:IS" ; Where: •ACTIVE indicates the AID of the currently active interface. •STANDBY indicates the AID of the interface in standby. •FENDDIRN indicates the switching mode of the remote facility. Valid values are as follows: –UNI - Unidirectional –BI - Bidirectional –UNKNOWN - Unknown Note If switching mode of this (near end) facility, that is PSDIRN is configured as UNI, then its active switching mode will always be UNI. If PSDIRN is configured as BIdirectional, then the active switching mode is BI only if the FENDDIRN is BI. If FENDDIRN is UNI, then the active switching mode becomes UNI. •MSGCHCUR indicates the currently used message channel. This parameter applies only when MSGCH is set to AUTO. •MSGCHST indicates if the message channel is up or down. Valid values are as follows: –IS - in service –OOS - out-of-service
Errors	Errors are listed in Table 2-15.

3.63 RTRV-FILE: Retrieve File


Section	RTRV-FILE Description
Category	Memory Management
Security	Retrieve
Related Messages	RTRV-LOG: Retrieve Log SET-ATTR-rr: Set Attributes
Input Format	RTRV-FILE:[<tid>]:<aid>:<ctag>:::FILENAME=<filename>,[LINES=<lines>], [OFFSET=<offset>]; Where: •<tid> is the target identifier. •<aid> indicates the memory device from which the file is to be retrieved. Valid values are BOOTFLASH, DISK-0, SBY-BOOTFLASH, SBY-DISK-0, NVRAM, SBY-NVRAM, and SYSTEM. •<ctag> is the correlation tag. •<filename> is a string that shows the name of the configuration file whose contents are to be retrieved. The maximum string length is 255 characters. •<lines> is an optional parameter. It is an integer value that indicates the number of lines to retrieve at a time. If this parameter is not configured, the entire file is retrieved as is. •<offset> is an optional parameter. It is an integer value that indicates the offset within a file. The contents of the file starting at this offset is retrieved. The default value is zero which means that the contents from the beginning of the file is retrieved.
Input Example	To retrieve the contents of the configuration files, use the following: RTRV-FILE:ons155xx::123:::FILENAME=running-config,LINES=24;
Output Format	SID DATE TIME M CTAG COMPLD "<text>" ;
Output Example	SID DATE TIME M 123 COMPLD "version 12.1 no service pad service timestamps debug uptime service timestamps log uptime no service password-encryption service internal service compress-config ! hostname snmp-hamp ! boot system bootflash:ons15530-i-mz redundancy keepalive-threshold 12 associate group bb associate group aa aps working Transparent8/0/0 aps protection Transparent9/0/0 aps y-cable aps enable aps timer switchover min-interval 20 enable password lab ! ! threshold-list abc" ;
Errors	Errors are listed in Table 2-15.

3.64 RTRV-GBE10: Retrieve 10-Gbps Interfaces

Use this command to retrieve the CDL related information for the given interface.

The PST and SST values in the last position defined block indicate the current status of the interface. The values of PST-PSTQ and SST, under different conditions, are listed as follows:

•

If the interface is administratively shut down by using the ENT-GBE10 command, values returned is PST=OOS-MA, SST=MT.

•

If the interface is administratively shut down and the laser is shut as well, values returned are PST=OOS-MA, SST=LASERSHUT.

•

If the interface is down because of alarms on the link, such as Loss of Signal/Loss of Frame, Loss of Light, values returned are PST=OOS-AU and SST=FAF.

•

If the interface is down because of Loss of Signal or Loss of Light, and safety protocols such as LSC, FLC, or OFC are enabled on the interface, causing the transmit laser to shut down, values returned are PST=OOS-AU and SST=LASERSHUT.

•

If the interface is down because of alarms and is also administratively shut down, values returned are PST=OOS-AUMA, SST=FAF, MT.

•

If there is an entity failure on the NE because the interface is down, values returned are PST=OOS-AU, SST= SGEO.

•

If the transmit laser fails at an interface, values returned are PST=OOS-AU, SST=FLT, LASERFAIL.

•

If only thresholds are being exceeded on the interface, values returned are PST=IS-ANR.


Section	RTRV-GBE10 Description
Category	10-Gbps interface configuration
Security	Retrieve
Related Messages	ED-GBE10: Edit 10-Gbps INIT-REG-GBE10: Initialize Register 10-Gbps OPR-LPBK-GBE10: Operate Loopback 10-Gbps RLS-LPBK-GBE10: Release Loopback on the 10-Gbps
Input Format	RTRV-GBE10:[<tid>]:[<aid>]:<ctag>; where: •<tid> is the target identifier. •<aid> identifies the WAVEETHERPHY-slot-0, WAVEPATCH-slot-0-port, and TENGIGETHERPHY-slot-0 interfaces. •<ctag> is the correlation tag.
Input Example	To retrieve the CDL Information from the WaveEtherPhy Interface in slot 9, use the following: RTRV-GBE10:ons155xx:WAVEETHERPHY-9-0:123;
Output Format	SID DATE TIME M CTAG COMPLD "<aid>:THRLISTNAME=<thrlistname>,FRCENDHOP=<frcendhop>, NODEBEHAVIOUR=<nodebehaviour>,LPBKTYPE=<lpbktype>:<pst>" ;
Output Example	SID DATE TIME M 123 COMPLD "WAVEETHERPHY-9-0:THRLISTNAME=cdl_thresh,FRCENDHOP=N, NODEBEHAVIOUR=ENDOFPATH, LPBKTYPE=FACILITY:IS-NR" ; Where: •<NODEBEHAVIOUR> indicates whether the interface is end-of-path or end-of-hop. Any OAM information associated with a path or hop is terminated on this interface. •<LPBKTYPE> indicates the type of loopback on the interface. Valid values are as follows: –FACILITY - where the signal from the receive input is looped back to the Tx output –TERMINAL - where the signal bound for Tx output is looped back to the receive input. This is an internal loopback and it is used for hardware debug and diagnostics.
Errors	Errors are listed in Table 2-15.

3.65 RTRV-HDR: Retrieve Header

Use this command to request that an NE simply reply with a normal response indicating COMPLD.

The information of interest in the reply is the reply itself, along with information that the NE has about itself, namely the <source_identifier>, the <date>, and the <time>.

3.66 RTRV-IP: Retrieve IP


Section	RTRV-IP Description
Category	IP configuration
Security	Retrieve
Related Messages	DLT-IP: Delete IP DLT-IPROUTE-STATIC: Delete IP Route Static ED-IP: Edit IP ENT-IP: Enter IP RTRV-IPROUTE: Retrieve IP Route SQUEEZE-MEM: Squeeze Memory
Input Format	RTRV-IP:[<tid>]:[<aid>]:<ctag>; Where: •<tid> is the target identifier. •<aid> is the access identifier. •<ctag> is the correlation tag.
Input Example	To retrieve IP configurations, use the following: RTRV-IP:ons155xx:FE-0:123;
Output Format	SID DATE TIME M CTAG COMPLD "<aid>:IPADDRTYPE=<ipaddrtype>,IPADDR=<ipaddr>,IPMASK=<ipmask>" ;
Output Example	SID DATE TIME M 123 COMPLD "FE-0:IPADDRTYPE=ADDR,IPADDR=172.16.42.110, IPMASK=255.255.255.0" ;
Errors	Errors are listed in Table 2-15.

3.67 RTRV-IPROUTE: Retrieve IP Route


Section	RTRV-IPROUTE Description
Category	IP configuration
Security	Retrieve
Related Messages	DLT-IPROUTE-STATIC: Delete IP Route Static ED-IP: Edit IP ENT-IP: Enter IP
Input Format	RTRV-IPROUTE:[<tid>]::<ctag>:::ROUTETYPE=<routetype>; Where: •<tid> is the target identifier. •<ctag> is the correlation tag. •<routetype> indicates if the route is a static route or is learned dynamically from a routing protocol. Valid values are STATIC and DYNAMIC. The only value supported by this parameter is STATIC.
Input Example	To retrieve IP routing information, use the following: RTRV-IPROUTE:ons155xx::123:::ROUTETYPE=STATIC;
Output Format	SID DATE TIME M CTAG COMPLD "ROUTETYPE=<routetype>,PREFIXADDR=<prefixaddr>, PREFIXMASK=<prefixmask>,ROUTEIF=<routeif>" ;
Output Example	SID DATE TIME M 123 COMPLD "ROUTETYPE=STATIC,PREFIXADDR=10.1.0.0, PREFIXMASK=255.255.0.0, ROUTEIF=WAVE-0-0" ;
Errors	Errors are listed in Table 2-15.

3.68 RTRV-LOG: Retrieve Log


Section	RTRV-LOG Description
Category	Alarms and faults
Security	Retrieve
Related Messages	ALW-MSG-ALL: Allow Message All ALW-SWDX-EQPT: Allow Switch Duplex Equipment INH-MSG-ALL: Inhibit Message All INH-SWDX-EQPT: Inhibit Switch Duplex Equipment RTRV-ALM-ALL: Retrieve Alarms All RTRV-ALM-ENV: Retrieve Alarms Environmental
Input Format	RTRV-LOG:[<tid>]::<ctag>::[<lognm>]; Where: •<tid> is the target identifier. •<ctag> is the correlation tag. •<lognm> specifies the name of the log to be retrieved. Only the value SYSLOG is currently supported. The default is SYSLOG.
Input Example	To retrieve the console buffer log on the NE, use the following: RTRV-LOG:ons155xx::123::;
Output Format	SID DATE TIME M CTAG COMPLD "<text>" ; /* RTRV-LOG */
Output Example	SID DATE TIME M 123 COMPLD "SYSLOG::00:00:23: %LINK-3-UPDOWN: Interface Transparent7/0/0, changed state to down" "SYSLOG::00:00:24: %LINEPROTO-5-UPDOWN: Line protocol on Interface Transparent7/0/0, changed state to down" "SYSLOG::00:00:38: %LCMDC-3-MIB_ICDRLK_ALM: Ingress CDR Locking error CLEAR MAJOR Tran7/0/0" ; /* RTRV-LOG */
Errors	Errors are listed in Table 2-15.

3.69 RTRV-MEM: Retrieve Memory

Use this command to retrieve information on all the files that are present on the Flash device.


Section	RTRV-MEM Description
Category	Memory Management
Security	Retrieve
Related Messages	DLT-MEM: Delete Memory CPY-MEM: Copy Memory RST-MEM: Restore Memory SQUEEZE-MEM: Squeeze Memory
Input Format	RTRV-MEM:[<tid>]:[<aid>]:<ctag>:::[FILENAME=<file>],[STATUS=<status>]; Where: •<tid> is the target identifier. •<aid> indicates the memory device from which the file is being retrieved. Valid values are BOOTFLASH, SBY-BOOTFLASH, DISK-0, SBY-DISK-0, NVRAM, SBY-NVRAM, and SYSTEM. •<ctag> is the correlation tag. •<file> specifies a filename. This is a string with a maximum of 255 characters. •<status> is the file status. You can use this parameter to filter the files that are retrieved. Valid values are ACTIVE, DELETED, and ALL. ACTIVE refers to all the files that are currently undeleted. DELETED refers to files that have been marked deleted. ALL is used to retrieves all files. The default value is ALL.
Input Example	To retrieve information on all the files that are present on the Flash device, use the following: RTRV-MEM:ons155xx:DISK-0:123;
Output Format	SID DATE TIME M CTAG COMPLD "<aid>:INDEX=<index>,ACCESS=<access>,SIZE=<size>,DATE=<date>, TIME=<time>,FILENAME=<filename>,STATUS=<status>" ;
Output Example	SID DATE TIME M 123 COMPLD "BOOTFLASH:INDEX=1,ACCESS=RW,SIZE=145678,DATE=12-115.01, TIME=10-22-00,FILENAME=ons15540-i-mz,STATUS=ACTIVE" "BOOTFLASH:INDEX=2,ACCESS=RW,SIZE=146140,DATE=12-115.01, TIME=13-10-00,FILENAME=ons15540-i-mz.temp,STATUS=DELETED" ; Where: •INDEX is the index number associated with the deleted file. •ACCESS is permissions on that file. Valid values are RW and RO. •SIZE is the size of the file in bytes. •DATE is the string that shows the date of the file. The format is MM-DD-YY. •TIME is the string that shows the time on the file. The format is HH-MM-SS. •NAME is the string that shows the name of the file. The maximum length is 255 characters.
Errors	Errors are listed in Table 2-15.

3.70 RTRV-NBR: Retrieve Neighbor

If the AID value is not provided, then information about all the neighbors discovered (for all of the ports) is retrieved.


Section	RTRV-NBR Description
Category	Topology neighbor configuration
Security	Retrieve
Related Messages	DLT-NBR: Delete Neighbor ENT-NBR: Enter Neighbor
Input Format	RTRV-NBR:[<tid>]:[<aid>]:<ctag>; •<tid> is the target identifier. •<aid> identifies the interface and can be one of the following: –TRANSPARENT-slot-0-0 –TENGIGETHERPHY-slot-0 –WDM-slot-subcard –VOAOUT-slot-subcard-port •<ctag> is the correlation tag.
Input Example	To retrieve the neighbor information on ports, use the following: RTRV-NBR:ons155xx:WDM-0-0:123;
Output Format	SID DATE TIME M CTAG COMPLD "<aid>:DSCVRY=<dscrvy>,LINKDIRN=<linkdirn>,NBRNAME=<nbrname>, NBRPORT=<nbrport>,NBRAGENTIP=<nbragentip>" ;
Output Example	SID DATE TIME M 123 COMPLD "WDM-0-0:DSCVRY=MANUAL,LINKDIRN=RX,NBRNAME=shelf2, NBRPORT=WDM-0-0, NBRAGENTIP=172.16.20.1" "WDM-0-0:DSCVRY=MANUAL,LINKDIRN=TX,NBRNAME=edfa_box1, NBRPORT=in_port, NBRAGENTIP=172.16.20.9" ;
Errors	Errors are listed in Table 2-15.

3.71 RTRV-NE-CDP: Retrieve Network Element CDP


Section	RTRV-NE-CDP Description
Category	CDP
Security	Retrieve
Related Messages	ED-NE-CDP: Edit Network Element CDP
Input Format	RTRV-NE-CDP:[<tid>]::<ctag>; Where: •<tid> is the target identifier. •<ctag> is the correlation tag.
Input Example	To retrieve global CDP information, use the following: RTRV-NE-CDP:ons155xx::123;
Output Format	SID DATE TIME M CTAG COMPLD "CDP=<cdp>,UPDATETIME=<updatetime>,HOLDTIME=<holdtime>, SENDVER=<sendver>" ;
Output Example	SID DATE TIME M 123 COMPLD "CDP=Y,UPDATETIME=60,HOLDTIME=180,SENDVER=2" ;
Errors	Errors are listed in Table 2-15.

3.72 RTRV-NE-GEN: Retrieve Generic NE Configuration Values


Section	RTRV-NE-GEN Description
Category	Generic NE configuration
Security	Retrieve
Related Messages	ED-NE-GEN: Edit Network Element General
Input Example	To retrieve generic NE configuration values, use the following: RTRV-NE-GEN:ons155xx::123;
Output Format	SID DATE TIME M CTAG COMPLD "CURCFGREG=<curcfgreg>,NEWCFGREG=<newcfgreg>, SWVER=<swver>,SWNAME=<swname>,SYSFILE=<sysfile>, CMPLTIME=<cmpltime>,CMPLBY=<cmplby>" ;
Output Example	SID DATE TIME M 123 COMPLD "CURCFGREG=0x0,NEWCFGREG=0x2,SWVER=12.1, SWNAME=ONS15540-I-M, SYSFILE=bootflash:ons15540-i-mz, CMPLTIME=01-10-11-19-33,CMPLBY=hqluong" ; Where: •CURCFGREG shows the current configuration register setting in hexadecimal. •NEWCFGREG shows the new (the value that takes effect on next reload) configuration register setting in hexadecimal. •SWVER indicates the software version; maximum length is 32 characters •SWNAME indicates the name of the software image, maximum length is 64 characters. •SYSFILE indicates the system image file; maximum length is 255 characters. •CMPLTIME indicates the compiled time. The format of this string is YY-MM-DD-HH-MM. •CMPLBY indicates the username of person who compiled this software image; maximum length is 8 characters.
Errors	Errors are listed in Table 2-15.

3.73 RTRV-NE-OSCP: Retrieve Network Element OSCP


Section	RTRV-NE-OSCP Description
Category	OSCP
Security	Retrieve
Related Messages	ED-NE-OSCP: Edit Network Element OSCP
Input Format	RTRV-NE-OSCP:[<tid>]::<ctag>; Where: •<tid> is the target identifier. •<ctag> is the correlation tag.
Input Example	To retrieve the configurations for OSCP, use the following: RTRV-NE-OSCP:ons155xx::123;
Output Format	SID DATE TIME M CTAG COMPLD "HELLOINTV=<hellointv>,HELLOHLDWN=<hellohldwn>, INACTFCTR=<inactfctr>" ;
Output Example	SID DATE TIME M 123 COMPLD "HELLOINTV=500,HELLOHLDWN=200,INACTFCTR=10" ;
Errors	Errors are listed in Table 2-15.

3.74 RTRV-NTP: Retrieve NTP


Section	RTRV-NTP Description
Category	NTP configuration
Security	Retrieve
Related Messages	DLT-NTPASSOC: Delete NTP Associations ENT-NTPASSOC: Enter NTP Associations
Input Format	RTRV-NTP:[<tid>]::<ctag>; Where: •<tid> is the target identifier. •<ctag> is the correlation tag.
Output Format	SID DATE TIME M CTAG COMPLD "SYNCSTATE=<syncstate>,STRATUM=<stratum>,REFIPADDR=<refipaddr>, NOMFREQ=<nomfreq>,ACTFREQ=<actfreq>,PRECISION=<precision>, REFTIME=<reftime>,CLKOFFSET=<clkoffset>,ROOTDELAY=<rootdelay>, ROOTDISP=<rootdisp>,PEERDISP=<peerdisp>" ;
Output Example	SID DATE TIME M 123 COMPLD "SYNCSTATE=Y,STRATUM=4,REFIPADDR=172.16.246.1,NOMFREQ=250, ACTFREQ=249.9999,PRECISION=24, REFTIME=09:09:38.885PSTSunDec302001,CLKOFFSET=7.7674, ROOTDELAY=113.39,ROOTDISP=386.72, PEERDISP=1.57" ; Where: •SYNCSTATE indicates whether clock is synchronized. Valid values are Y or N. •STRATUM indicates the stratum of the reference clock. This is an integer value from 1 to 16. •REFIPADDR indicates the IP address of the peer/server from where the reference clock is being derived. •NOMFREQ is the nominal frequency in Hz. •ACTFREQ is the actual frequency in Hz. •PRECISION indicates the precision of the derived clock. If the value specified here is x, the actual precision is of the form 2^x. •REFTIME indicates the clock reference time. •CLKOFFSET is the clock offset in msec. •ROOTDELAY a string value that shows the root delay in msec. •ROOTDISP is the root dispersion in msecs. •PEERDISP is the peer dispersion in msecs.
Errors	Errors are listed in Table 2-15.

3.75 RTRV-NTPASSOC: Retrieve NTP Associations

Use this command to retrieve the NTP parameters for each association that is created.


Section	RTRV-NTPASSOC Description
Category	NTP configuration
Security	Retrieve
Related Messages	DLT-NTPASSOC: Delete NTP Associations ENT-NTPASSOC: Enter NTP Associations RTRV-NTP: Retrieve NTP
Input Format	RTRV-NTPASSOC:[<tid>]::<ctag>; Where: •<tid> is the target identifier. •<ctag> is the correlation tag.
Output Format	SID DATE TIME M CTAG COMPLD "ASSOCTYPE=<assoctype>,ASSOCIPADDR=<associpaddr>, ASSOCSTRATUM=<assocstratum>,ASSOCREFID=<assocrefid>, ASSOCPOLL=<assocpoll>,ASSOCREACH=<assocreach>, ASSOCDELAY=<assocdelay>,ASSOCOFFSET=<assocoffset>, ASSOCDISP=<assocdisp>" ;
Output Example	SID DATE TIME M 123 COMPLD "ASSOCTYPE=SERVER,ASSOCIPADDR=172.16.246.1, ASSOCSTRATUM=2,ASSOCREFID=172.16.10.80,ASSOCPOLL=64, ASSOCREACH=377,ASSOCDELAY=1.4,ASSOCOFFSET=-23005, ASSOCDISP=4925" ; Where: •ASSOCTYPE shows the association type. The values are SERVER and PEER. •ASSOCIPADDR shows the IP address of the server or peer. •ASSOCSTRATUM the stratum of the peer's clock, is an integer value from 1 to 16. •ASSOCREFID indicates the reference ID of the peer is an IP address •ASSOCPOLL indicates the interval at which the local host polls the peer. This is an integer value in seconds. •ASSOCREACH indicates the reachability status of the peer. This is an integer value from 0 to 255. •ASSOCDELAY is the estimated round-trip delay of the peer clock with reference to the local clock, in seconds. •ASSOCOFFSET is the estimated offset of the peer clock with reference to the local clock, in seconds. •ASSOCDISP is the estimated error between the peer clock and the local clock, in seconds.
Errors	Errors are listed in Table 2-15.

3.76 RTRV-OCH: Retrieve Optical Channel

The PST and SST values in the last position defined block indicate the current status of the interface. The values of PST-PSTQ and SST, under different conditions, are listed as follows:

•

If the interface is administratively shut down by using the ENT-OCH command, values returned are PST=OOS-MA, SST=MT.

•

If the interface and the laser are shut down administratively, values returned are PST=OOS_MA, SST=MT, LASER.

•

If the interface is down because of alarms on the link, such as Loss of Signal/Loss of Frame, Loss of Light, values returned are PST=OOS-AU, SST=FAF.

•

If the interface is down because of alarms and is also administratively shut down, values returned are PST=OOS-AUMA, SST=FAF, MT.

•

If there is an entity failure on the NE because the interface is down, values returned are PST=OOS-AU, SST= SGEO.

•

If the transmit laser fails at an interface, values returned is PST=OOS-AU, SST=FLT.

•

If only thresholds are exceeded on the interface, values returned are PST=IS-ANR. For wavepatch interfaces only, the SST value also indicates the current state with respect to APS of the interface.


Section	RTRV-OCH Description
Category	Transparent interface configuration
Security	Retrieve
Related Messages	ED-OCH: Edit Optical Channel OPR-LPBK-OCH: Operate Loopback OCH RTRV-OCH: Retrieve Optical Channel RTRV-OCH: Retrieve Optical Channel
Input Format	RTRV-OCH:[<tid>]:[<aid>]:<ctag> Where: •<aid> indicates the interface configured. Valid values of AID are TRANSPARENT-slot-0-0, WAVE-slot-0, WAVEPATCH-slot-0-port, WAVEETHERPHY-slot-0, or ETHERDCC-slot-0-0.
Input Example	To retrieve interface configuration information, use the following: RTRV-OCH:ons155xx:TRANSPARENT-10-0-0:123; RTRV-OCH:ons155xx:WAVE-8-0:123;
Output Format	Output format for a transparent interface: SID DATE TIME M CTAG COMPLD "<aid>:ENCAP=<encap>,RATE=<rate>,THRLISTNAME=<thrlistname>, FLC=<flc>,OFC=<ofc>,CDP=<cdp>,LPBKTYPE=<lpbktype>:<pst>" ; Output format for a wave or waveetherphy interface: SID DATE TIME M CTAG COMPLD "<aid>:THRLISTNAME=<thrlistname>,FLC=<flc>,LSC=<lsc>, LASERFREQ=<laserfreq>,LPBKTYPE=<lpbktype>:<pst>" ;
Output Example	SID DATE TIME M 123 COMPLD "TRANSPARENT-10-0-0:ENCAP=OC3,THRLISTNAME=sonet-cvs,FLC=N, LPBKTYPE=FACILITY:IS-NR" ; SID DATE TIME M 123 COMPLD "WAVE-8-0:THRLISTNAME=sonet-cvs,FLC=N,LSC=Y, LASERFREQ=159800, LPBKTYPE=FACILITY:IS-NR" ; Where: •LASERFREQ can be retrieved only on AIDs WAVE-slot-0 and WAVEETHERPHY-slot-0. •LPBKTYPE indicates the type of loopback on the interface. Valid values are as follows: –FACILITY - where the signal from the receive input is looped back to the transmit output. –TERMINAL - where the signal bound for transmit output is looped back to the receive input. This is an internal loopback and it is used for hardware debug and diagnostics.
Errors	Errors are listed in Table 2-15.

3.77 RTRV-PATCH: Retrieve Patch


Section	RTRV-PATCH Description
Category	Patch configuration
Security	Retrieve
Related Messages	DLT-PATCH: Delete Patch ENT-PATCH: Enter Patch
Input Format	RTRV-PATCH:[<tid>]:[<from_aid>],[<to_aid>]:<ctag>; Where: •<tid> is the target identifier. •<from_aid> identifies the port patched to the port identified by <to_aid>. Valid values for <from_aid> are as follows: –FILTER-slot-0-0 –OSCFILTER-slot-0 –THRU-slot-0 –VOAFILTERIN-slot-subcard-port –VOAFILTEROUT-slot-subcard-port –VOAIN-slot-subcard-port –VOAOUT-slot-subcard-port –WAVE-slot-subcard –WAVEPATCH-slot-0-port –WDM-slot-0 •<to_aid> identifies the port patched from the port identified by <from_aid>. Valid values for <to_aid> are as follows: –FILTER-slot-0-0 –OSCFILTER-slot-0 –THRU-slot-0 –VOAFILTERIN-slot-subcard-port –VOAFILTEROUT-slot-subcard-port –VOAIN-slot-subcard-port –VOAOUT-slot-subcard-port –WAVE-slot-subcard –WAVEPATCH-slot-0-port –WDM-slot-0 •<ctag> is the correlation tag. Note The AIDs and parameters are as described in the "ENT-PATCH: Enter Patch" section. If the AID value is not provided then information for all the patches is retrieved. If both the AIDs are specified, all the patches associated with the specified AIDs is retrieved.
Input Example	To retrieve the patch configuration, use the following: RTRV-PATCH:ons155xx::123;
Output Format	SID DATE TIME M CTAG COMPLD "<from_aid>,<to_aid>:<dirn>" ;
Output Example	SID DATE TIME M 123 COMPLD "WAVEPATCH-2-0-0,FILTER-0-0-0:2WAY" "WDM-0-0,THRU-0-0:2WAY" ;
Errors	Errors are listed in Table 2-15.

3.78 RTRV-PM-ENCAP: Retrieve Performance Encapsulation

Use this command to retrieve the performance monitoring parameters related to error counters for transponder and OSC wave interfaces specified by the AID. The parameter is specified by <montype> and <tmper> specifies the accumulation time period.


Section	RTRV-PM-ENCAP Description
Category	Transparent interface configuration
Security	Retrieve
Related Messages	ED-OCH: Edit Optical Channel
Input Format	RTRV-PM-ENCAP:[<tid>]:[<aid>]:<ctag>::[<montype>],,,,[<tmper>], [<mondat>],[<montm>]; Where: •<tid> is the target identifier. •<aid> indicates transparent interface or wave interface for which performance monitoring data is being retrieved. The value of the AID can be TRANSPARENT-slot-0-0 or WAVE-slot-subcard. •<ctag> is the correlation tag. •<montype> is monitored parameter type. Valid values are as follows: –FC - Indicates the number of times signal failure threshold was exceeded on an interface. –DC - Indicates the number of times signal degrade threshold was exceeded on an interface. –PSC - Shows protection switch count (for APS) on the AID. –ESS - Errored Second count (Section). –SEFS-S - Severely errored framing seconds count. –SESS - Severely errored second count. –CVRD - Coding violations and running disparity errors. –CDLHEC - CDL header error count. This parameter applies to the OSC WAVE-slot AIDs only. The default is all montypes. •<tmper> is the time period for the counts. Valid values are 15-MIN, 24-HR, or TOTAL. The 15-MIN and 24-HR counts are reported only for the SONET-related counters CVS, ESS, SEFS-S, and SESS. For all other counters, only TOTAL counts are reported. •<mond> is the day the AID was monitored. The format is YY-MM-DD. •<montm> is the time the AID was monitored. The format is HH:SS.
Input Example	To retrieve the performance monitoring parameters for the transparent interface in slot 2, use the following: RTRV-PM-ENCAP:ons155xx:TRANSPARENT-2-0-0:123;
Output Format	SID DATE TIME M CTAG COMPLD "<aid>:<error>,<count>,COMPL,,,<interval>,," ;
Output Example	SID DATE TIME M 123 COMPLD "TRANSPARENT-2-0-0,OC3:CVS,153,COMPL,,,15-MIN" "TRANSPARENT-2-0-0,OC3:FC,0,COMPL,,,TOTAL" "TRANSPARENT-2-0-0,OC3:DC,5,COMPL,,,TOTAL" "TRANSPARENT-2-0-0,OC3:PSC,6,COMPL,,,TOTAL" ; Where: •FC indicates the number of times signal failure threshold was exceeded on an interface. •DC indicates the number of times signal degrade threshold was exceeded on an interface. •PSC is the protection switch count (for APS) on the interface. Note Valid values for the time period for this command include 15-MIN, 24-HR and TOTAL. The 15-MIN and 24-HR counts are reported only for SONET related counters. That is CVS, ESS, SEFS-S, SESS. For all other counters, only TOTAL counts is reported.
Errors	Errors are listed in Table 2-15.

3.79 RTRV-PM-EQPT: Retrieve Performance Monitoring Equipment

Use this command to retrieve performance monitoring data for the CPU switch module.


Section	RTRV-PM-EQPT Description
Category	Redundancy configuration
Security	Retrieve
Related Messages	INIT-REG-ETH: Initialize Register Ethernet
Input Format	RTRV-PM-EQPT:[<tid>]:[<aid>]:<ctag>; Where: •<tid> is the target identifier. •<aid> is the access identifier. The AID used in this command is SLOT-5 or SLOT-6. •<ctag> is the correlation tag.
Input Example	To retrieve performance monitoring parameters for the CPU switch module in slot 5, use the following: RTRV-PM-EQPT:ons155xx:SLOT-5:123;
Output Format	SID DATE TIME M CTAG COMPLD "<aid>:<montype>,<count>,,,,<time>" ;
Output Example	SID DATE TIME M 123 COMPLD "Slot-5:SWCT,1,,,," "Slot-5:SWTM,0,,,,01-10-11-19-33" "Slot-5:AVAILUPTM,0,,,,00-00-03-04-35" "Slot-5:INITM,0,,,,00-00-00-22-33" "Slot-5:RCSYNCTM,0,,,,00-00-00-02-18" "Slot-5:SCSYNCTM,0,,,,00-00-00-06-01" ; /* RTRV-PM-EQPT */ Where: •SWCT is an integer and shows switchover counts. •SWTM is a string and shows the last switchover time in YY-MM-DD-HH-MM. •AVAILUPTM is the available uptime such as time since the last event when the entire system was down. The format is YY-MM-DD-HH-MM. •INITM is the time since this module was initialized. The format is YY-MM-DD-HH-MM. •RCSYNCTM is the time since last running-config sync. The format is YY-MM-DD-HH-MM. •SCSYNCTM is the time since the last startup-configuration and startup-config sync. The format is YY-MM-DD-HH-MM.
Errors	Errors are listed in Table 2-15.

3.80 RTRV-PM-ESCON: Retrieve Performance Monitoring on ESCON

Use this command to retrieve the performance monitoring parameters for a particular ESCON interface specified by the AID.


Section	RTRV-PM-ESCON Description
Category	ESCON interface configuration
Security	Retrieve
Related Messages	ED-ESCON: Edit ESCON RTRV-ESCON: Retrieve ESCON
Input Format	RTRV-PM-ESCON:[<tid>]:[<aid>]:<ctag>::[<montype>],,,[<tmper>]; Where: •<tid> is the target identifier. •<aid> identifies the ESCON-slot-0-port. •<ctag> is the correlation tag. •<montype> specifies the performance monitoring parameter. Valid values are as follows: –CVRD specifies coding violations and running disparity errors count. –CRC specifies cyclic redundancy checksum errors. –CDLHEC specifies CDL header error counts. •<tmper> specifies the accumulation time period.
Output Format	SID DATE TIME M CTAG COMPLD "<aid>:<montype>,<count>,COMPL,,,<interval>" ;
Output Example	SID DATE TIME M 123 COMPLD "ESCON-2-0-0:FENDPAKIND,20,COMPL,,,TOTAL" "ESCON-2-0-0:CRC,50,COMPL,,,TOTAL" "ESCON-2-0-0:CVRD,200,COMPL,,,TOTAL" ; Where: •FENDPAKIND indicates ingress errors from far end of an Ethernet network, where ESCON streams are encapsulated in Ethernet packets. •CVRD indicates coding violations and running disparity errors count. •CRC indicates cyclic redundancy checksum errors.
Errors	Errors are listed in Table 2-15.

3.81 RTRV-PM-GBE10: Retrieve Performance Monitoring 10-Gbps

Use this command to retrieve the performance monitoring parameters on the 10-Gbps interfaces.


Section	RTRV-PM-GBE10 Description
Category	10-Gbps interface configuration
Security	Retrieve
Related Messages	RTRV-PM-rr: Retrieve Performance Monitoring
Input Format	RTRV-PM-GBE10:[<tid>]:[<aid>]:<ctag>::[<montype>],,,, [<tmper>],[<mondat>],[<montm>]; Where: •<tid> is the target identifier. •<aid> identifies the WAVEETHERPHY-Slot-0 and the TENGIGETHERPHY-Slot-0 interfaces. •<ctag> is the correlation tag. •<montype> specifies the performance monitoring parameter. •<tmper> specifies the accumulation time period. •<montype> specifies the performance monitoring parameter. Valid values are as follows: –CVRD specifies coding violations and running disparity errors count. –CRC specifies cyclic redundancy checksum errors. •<tmper> specifies the accumulation time period.
Input Example	To retrieve the performance monitoring information related to error counters from waveetherphy interface in slot 9, use the following: RTRV-PM-GBE10:ons155xx:WAVEETHERPHY-9-0:123;
Output Format	SID DATE TIME M CTAG COMPLD "<aid>:<error>,<count>,COMPL,,,,<interval>" ;
Output Example	SID DATE TIME M 123 COMPLD "WAVEETHERPHY-9-0:CRC,50,COMPL,,,TOTAL" "WAVEETHERPHY-9-0:CVRD,60,COMPL,,,TOTAL" "WAVEETHERPHY-9-0:CDLHEC,500,COMPL,,,TOTAL" "WAVEETHERPHY-9-0:INVALIDFLOWID,10000,COMPL,,,TOTAL" "WAVEETHERPHY-9-0:NONCDLPAK,15.0,COMPL,,,TOTAL" ; Where: •CDLHEC indicates CRC error counts in the CDL header. •INVALIDFLOWID indicates the count associated with the CDL Flow Identifier lookup errors encountered in the receive direction. •NONCDLPAK indicates the count associated with the number of packets received without a CDL header in the receive direction. This counter is incremented only when CDL is enabled on the interface.
Errors	Errors are listed in Table 2-15.

3.82 RTRV-PMMODE-OCH: Retrieve Performance Mode OCH


Section	RTRV-PMMODE-OCH Description
Category	Transparent interface configuration
Security	Retrieve
Related Messages	SET-PMMODE-OCH: Set Performance Mode OCH
Input Format	RTRV-PMMODE-OCH:[<tid>]:[<aid>]:<ctag>; Where: •<tid> is the target identifier. •<aid> is the access identifier. The value is TRANSPARENT-slot-0-0. •<ctag> is the correlation tag.
Input Example	To retrieve the configuration for performance monitoring, use the following: RTRV-PMMODE-OCH:ons155xx:TRANSPARENT-10-0-0:123;
Output Format	SID DATE TIME M CTAG COMPLD "<aid>:,,<pmmode>" ;
Output Example	SID DATE TIME M 123 COMPLD "TRANSPARENT-10-0-0:,,ON" ;
Errors	Errors are listed in Table 2-15.

3.83 RTRV-PM-rr: Retrieve Performance Monitoring

Use this command to retrieve the performance monitoring information for optical parameters on an interface specified by the AID. The parameter is specified by <montype> and <tmper> specifies the accumulation time period.

Note The value returned for all optical power related montype parameters is in the range of -40 to 25 dBm. The value returned for all laser bias current related montype parameters is in hundreds of microamperes and has a range from 0 to 10000.The value returned for all laser temperature related montype parameters is in 1/10ths of degrees centigrade and has a range from -500 to 850.


Section	RTRV-PM-rr Description
Category	Optical Parameter Monitoring
Security	Retrieve
Related Messages	RTRV-PM-EQPT: Retrieve Performance Monitoring Equipment RTRV-PM-ENCAP: Retrieve Performance Encapsulation
Input Format	RTRV-PM-rr:[<tid>]:[<aid>]:<ctag>::[<montype>],[<monlev>],,[<dirn>], [<tmper>],[<mondat>],[<montm>]; Where: •rr can be OCH or WDM. •<tid> is the target identifier. •<aid >is the access identifier. When rr is OCH, the value of AID can be WAVE-slot-0, WAVEETHERPHY-slot-0, WAVEPATCH-slot-0-port or VOAIN-slot-subcard-port. When the rr is WDM, the AID can be VOAIN-slot-subcard-port or VOAFILTERIN-slot-subcard-port. •<ctag> is the correlation tag. •<montype> is the performance monitoring parameter. Valid values are as follows: –OPR indicates the current value of the received optical power level. –OPRMIN indicates the minimum value of the received optical power level during a particular interval. –OPRMAX indicates the maximum value of the received optical power level during a particular interval. –OPRAVG indicates the average value of the received optical power level during a particular interval. •<monlev> is the level for the performance monitoring parameter. Valid values are n-UP and n-DN, where n is a decimal number indicating the number of levels in the desired direction. •<dirn> is the direction. Valid values are RCV or TRMT. •<tmper> is the time period for the counts. Valid values are 15-MIN, 24-HR, or TOTAL. The 15-MIN and 24-HR counts are reported only for the SONET-related counters CVS, ESS, SEFS-S, and SESS. For all other counters, only TOTAL counts are reported. •<mond> is the day the AID was monitored. The format is YY-MM-DD. •<montm> is the time the AID was monitored. The format is HH:SS.
Input Example	To retrieve the performance monitoring information for the optical parameters monitored on the wavepatch interface in slot 8, port 0, use the following: RTRV-PM-OCH:ons155xx:WAVEPATCH-8-0-0:123;
Output Format	SID DATE TIME M CTAG COMPLD "<aid>:<montype>,<value>,COMPL,,<dirn>,<interval>,<date>,<time>" ;
Output Example	SID DATE TIME M 123 COMPLD "WAVEPATCH-8-0-0:OPR,11.0,COMPL,,RCV,CURRENT" "WAVEPATCH-8-0-0:OPRMIN,5.0,COMPL,,RCV,15-MIN,05-09,22-45" "WAVEPATCH-8-0-0:OPRMAX,15.0,COMPL,,RCV,15-MIN,05-09,22-45" "WAVEPATCH-8-0-0:OPRAVG,10.0,COMPL,,RCV,15-MIN,05-09,22-45" ; Where: •OPR indicates the current value of the received optical power level. •OPRMIN indicates the minimum value of the received optical power level during a particular interval. •OPRMAX indicates the maximum value of the received optical power level during a particular interval. •OPRAVG indicates the average value of the received optical power level during a particular interval.
Input example	To retrieve information for optical power that is being monitored on the voafilterin interface in slot 8, subcard 0, port 0, subport 0, use the following: RTRV-PM-WDM:ons155xx:VOAFILTERIN-8-0-0-0:123;
Output example	SID DATE TIME M 123 COMPLD "VOAFILTERIN-8-0-0-0:OPR,11.0,COMPL,,RCV,CURRENT" "VOAFILTERIN-8-0-0-0:OPRMIN,5.0,COMPL,,RCV,15-MIN,05-09,22-45" "VOAFILTERIN-8-0-0-0:OPRMAX,15.0,COMPL,,RCV,15-MIN,05-09,22-45" "VOAFILTERIN-8-0-0-0:OPRAVG,10.0,COMPL,,RCV,15-MIN,05-09,22-45" ;
Errors	Errors are listed in Table 2-15.

3.84 RTRV-THR-OCH: Retrieve Thresholds OCH

Use this command to retrieve the configurations for thresholds. The complete threshold list or specific thresholds within the list can be retrieved.

Note When retrieving a particular threshold from a list, both the ERRTYPE and THRTYPE parameters, along with the THRLISTNAME, must be specified.


Section	RTRV-THR-OCH Description
Category	Threshold list configuration
Security	Retrieve
Related Messages	DLT-THR-OCH: Delete Threshold OCH ENT-THR-OCH: Enter Thresholds OCH RTRV-TH-rr: Retrieve Threshold SET-TH-rr: Set Optical Threshold
Input Format	RTRV-THR-OCH:[<tid>]:[<thrlistname>]:<ctag>:::[ERRTYPE=<errtype>, THRTYPE=<thrtype>]; Where: •<tid> is the target identifier. •<thrlistname> specifies the threshold list. •<ctag> is the correlation tag. •<errtype> indicates the type of error counter to which the threshold applies. Valid values are as follows: –CVS - SONET/SDH section CV errors –CVRD - 8B/10B code violations and running disparity errors –CDLHEC - CDL HEC errors –CRC - Cyclic redundancy check errors •<thrtype> indicates the threshold type. Valid values are as follows: –DEGR - Indicates that a signal degrade condition has been reached. Use this threshold type only when <errtype> is CVS. –FAIL - Indicates that a signal failure condition has been reached. Use this threshold type only when <errtype> is CVS. –EVTTHR -Indicates that a non-service affecting condition has been reached. Use this threshold type when <errtype> is not CVS. –ALMTHR - Indicates that a service affecting condition has been reached. Use this threshold type when <errtype> is not CVS.
Input Example	To retrieve the configurations for thresholds, use the following: RTRV-THR-OCH:ons155xx:sonet-cvs:123;
Output Format	SID DATE TIME M CTAG COMPLD "<thrlistname>:ERRTYPE=<errtype>,THRTYPE=<thrtype>,VALUE=<value>, INDEX=<index>,TRGAPS=<trgaps>,DESCR=<descr>" ;
Output Example	SID DATE TIME M 123 COMPLD "sonet-cvs:ERRTYPE=CVS,THRTYPE=DEGR,VALUE=7,INDEX=1, TRGAPS=Y,DESCR=xxx" ;
Errors	Errors are listed in Table 2-15.

3.85 RTRV-TH-rr: Retrieve Threshold

Use this command to retrieve the threshold values configured on the wavepatch, waveetherphy, voain, and voafilterin interfaces.


Section	RTRV-TH-rr Description
Category	Optical Parameter Monitoring
Security	Retrieve
Related Messages	ED-THR-OCH: Edit Thresholds OCH SET-TH-rr: Set Optical Threshold
Input Format	RTRV-TH-rr:[<tid>]:[<aid>]:<ctag>::[<montype>]; Where: •rr can be OCH or WDM. •<tid> is the target identifier. •<aid> indicates wavepatch, waveetherphy or voain interfaces on which the threshold is to be set. When rr is set to OCH, valid values are WAVEPATCH-slot-0-port or WAVEETHERPHY-slot-0. When rr is set to WDM, the value is VOAIN-slot-subcard-port or VOAFILTERIN-slot-subcard-slot. •<ctag> is the correlation tag. •<montype> is the performance monitoring parameter. Valid values are as follows: –OPR indicates the current value of the received optical power level. –OPRMIN indicates the minimum value of the received optical power level during a particular interval. –OPRMAX indicates the maximum value of the received optical power level during a particular interval. •OPRAVG indicates the average value of the received optical power level during a particular interval.
Input Example	To retrieve the threshold values configured on the wavepatch interface in slot 8, port 0, use the following: RTRV-TH-OCH:ons155xx:WAVEPATCH-8-0-0:123::OPRHA; To retrieve the threshold values configured on the voafilterin interfaces in slot 9, subcard 0, port 0, subport 0, use the following: RTRV-ATTR-WDM:ons155xx:VOAFILTERIN-9-0-0-0:123::,OPRHA;
Output Format	SID DATE TIME M CTAG COMPLD "<aid>:<montype>,,<dirn>,<value>" ;
Output Example	SID DATE TIME M 123 COMPLD "WAVEPATCH-8-0-0:OPRHA,,RCV,200" ; SID DATE TIME M 123 COMPLD "VOAFILTERIN-9-0-0-0:MJ,OPRHA,,RCV" ;
Errors	Errors are listed in Table 2-15.

3.86 RTRV-TOD: Retrieve Time of Day


Section	RTRV-TOD Description
Category	Generic NE configuration
Security	Retrieve
Related Messages	ED-DAT: Edit Date
Input Format	RTRV-TOD:[<tid>]::<ctag>; Where: •<tid> is the target identifier. •<ctag> is the correlation tag.
Input Example	To retrieve TOD information for the NE, use the following: RTRV-TOD:ons155xx::123;
Output Format	SID DATE TIME M CTAG COMPLD "<year>,<month>,<day>,<hour>,<minute>, <second>.<thousandths-of-second>,<timezone>" ;
Output Example	SID 2003-02-11 13:30:51 M 123 COMPLD "2003,2,11,13,30,51.879,UTC" ;
Errors	Errors are listed in Table 2-15.

3.87 RTRV-USER-SECU: Retrieve User Security

Use this command to retrieve the security parameters associated with a user, except for the password.


Section	RTRV-USER-SECU Description
Category	Security
Security	Retrieve
Related Messages	ACT-USER: Activate User CANC-USER: Cancel User DLT-USER-SECU: Delete User Security ED-USER-SECU: Edit User Security ENT-USER-SECU: Enter User Security
Input Format	RTRV-USER-SECU:[<tid>]:<uid>:<ctag>; Where: •<tid> is the target identifier. •<uid> is the user identifier. •<ctag> is the correlation tag.
Input Example	To retrieve the security parameters associated with a user, use the following: RTRV-USER-SECU:ons155xx:admin:123;
Output Format	SID DATE TIME M CTAG COMPLD "<uid>:,<security>:" ;
Output Example	SID DATE TIME M 123 COMPLD "admin:,PROV:" ;
Errors	Errors are listed in Table 2-15.

3.88 RTRV-VOA: Retrieve VOA

Use this command to retrieve the attenuation or power level configured for VOA interfaces.


Section	RTRV-VOA Description
Category	VOA interface configuration
Security	Retrieve
Related Messages	SET-VOA: Set VOA
Input Format	RTRV-VOA:[<tid>]:[<aid>]:<ctag>; Where: •<tid> is the target identifier. •<aid> indicates transparent or wave interface for which performance monitoring data is being retrieved. Valid values are VOAIN-slot-subcard-port or VOAFILTERIN-slot-subcard-port. •<ctag> is the correlation tag.
Input Example	To retrieve the attenuation or power level configured for VOA interfaces, use the following: RTRV-VOA:ons155xx:VOAIN-8-0-0:123;
Output Format	SID DATE TIME M CTAG COMPLD "<aid>:ATTENMODE=<attenmode>,DESPOWER=<despower>, CURATTEN=<curatten>,CURPOWER=<curpower>, MINATTEN=<minatten>,MAXATTEN=<maxatten>:<pst>" ;
Output Example	SID DATE TIME M 123 COMPLD "VOAIN-8-0-0:ATTENMODE=AUTO,DESPOWER=100,CURATTEN=3, CURPOWER=110,MINATTEN=3,MAXATTEN=308:IS-NR" ; Where: •CURATTEN indicates the current attenuation amount that is being applied at the interface. This value is in dB and has a range from 0 to 40. •CURPOWER indicates the current power level that is being measured on this interface. This value is measured in dBm and has a range from -40 to 25. •MINATTEN indicates the minimum attenuation amount that can be configured on this interface. This value is measured in dB and has a range from 0 to 40. •MAXATTEN indicates the maximum attenuation amount that can be configured on this interface. This value is in dB and has a range from 0 to 40. For manual mode, the parameters retrieved by this command are DESATTEN, CURATTEN, CURPOWER, MINATTEN, and MAXATTEN.
Errors	Errors are listed in Table 2-15.

3.89 SET-ATTR-rr: Set Attributes


Section	SET-ATTR-rr Description
Category	Optical Parameter Monitoring
Security	Retrieve
Related Messages	RTRV-OCH: Retrieve Optical Channel RTRV-TH-rr: Retrieve Threshold RTRV-THR-OCH: Retrieve Thresholds OCH SET-TH-rr: Set Optical Threshold
Input Format	SET-ATTR-rr:[<tid>]:<aid>:<ctag>::[<ntfcncde>],[<condtype>],,[<dirn>]; Where: •rr can be OCH or WDM. •<tid> is the target identifier. •<aid> is the access identifier. When rr is OCH, the value of AID can be WAVEPATCH-slot-0-port, WAVEETHERPHY-slot-0 or VOAIN-slot-subcard-port. When rr is WDM, the AID can be VOAIN-slot-subcard-port or VOAFILTERIN-slot-subcard-port. Thresholds for receive parameters can be configured only on the WAVEPATCH-slot-0-port, VOAIN-slot-subcard-port or VOAFILTERIN-slot-subcard-port interfaces. Thresholds for the transmit parameters can be configured only on the WAVEETHERPHY-slot-0 interfaces. •<ctag> is the correlation tag. •<ntfcncde> indicates the type of notification generated on the NE when a threshold is exceeded or cleared. When the montype parameter corresponds to the high alarm or the low alarm conditions, the notification code can have values CR (critical) or MJ (major) only. The condition is reported through REPT ALM service affect flag is set to SA. When the montype parameter corresponds to the high warning or low warning conditions, the notification code can have values MN (minor), NA (not alarmed) or NR (not reported). When the notification code is set to MN, the condition is reported through REPT ALM and the service affect flag is NSA. When the notification code is set to NA, the condition is reported through REPT EVT and the condeff flag is set to SC. When the notification code is set to NR, the condition will not be reported (the information can be retrieved from the NE) and the condeff flag is set to SC. •<condtype> is monitored condition type. Valid values are as follows: –OPRHA - Receive optical power level corresponding to the high alarm threshold. If the optical power level is greater than the threshold associated with this parameter, an alarm is generated. –OPRLA - Receive optical power level corresponding to the low alarm threshold. If the optical power level is less than the threshold associated with this parameter, an alarm is generated. –OPRHW - Receive optical power level corresponding to the high warning threshold. If the optical power level is greater than the threshold associated with this parameter, a warning is generated that may be reported using REPT EVT. –OPRLW - Receive optical power level corresponding to the low warning threshold. If the optical power level is less than the threshold associated with this parameter, a warning is generated that may be reported using the REPT EVT. •<dirn> is the direction associated with the information. Valid values are RCV or TRMT. The default is both directions.
Input Example	To configure a severity of MJ on the high alarm threshold on the received optical power, at the WAVEPATCH interface in slot 8, port 0, use the following: SET-ATTR-OCH:ons155xx:WAVEPATCH-8-0-0:123::MJ,OPRHA,,RCV; To configure a severity of MJ on the high alarm threshold on the received optical power, at the voafilterin interface in slot 8, subcard 0, port 0, subport 0, use the following: SET-ATTR-WDM:ons155xx:VOAFILTERIN-8-0-0-0:123::MJ,OPRHA,,RCV;
Errors	Errors are listed in Table 2-15.

3.90 SET-NTP: Set NTP


Section	SET-NTP Description
Category	NTP
Security	Maintenance
Related Messages	RTRV-NTP: Retrieve NTP
Input Format	SET-NTP:[<tid>]::<ctag>:::[MASTER=<master>],[MSTRATUM=<mstatum>], [MAXASSOC=<maxassoc>], [CLKPERIOD=<clkperiod>],[UPDCAL=<updcal>]; Where: •<tid> is the target identifier. •<ctag> is the correlation tag. •<master> enables or disables this NE to act as NTP master clock.Valid values are Y or N. The default is N. •<mstratum> indicates stratum value to use while acting as NTP master clock. •<maxassoc> sets the maximum number of NTP associations allowed. Valid values are 0 to 4294967295 . •<clkperiod> sets the length of hardware clock tick in 2^-32 seconds. Valid values are 0 to 4294967295. •<updcal> indicates whether the NE should update its internal hardware clock with clock value obtained from NTP. Valid values are Y or N. The default is N.
Errors	Errors are listed in Table 2-15.

3.91 SET-PMMODE-OCH: Set Performance Mode OCH

Use this command to enable and disable performance monitoring on a transparent interface. The <locn> and <modetype> parameters in this command do not apply and are set to NULL.


Section	SET-PMMODE-OCH Description
Category	Transparent interface configuration
Security	Maintenance
Related Messages	RTRV-PMMODE-OCH: Retrieve Performance Mode OCH
Input Format	SET-PMMODE-OCH:[<tid>]:<aid>:<ctag>::,,<pmstate>; Where: •<tid> is the target identifier. •<aid> is the access identifier. The value is TRANSPARENT-slot-0-0. •<ctag> is the correlation tag. •<pmstate> is the performance monitoring state. Valid values are ON or OFF. The default value is OFF.
Input Example	To enable monitoring on the transparent interface in slot 2, use the following: SET-PMMODE-OCH:ons155xx:TRANSPARENT-2-0-0:123::,,ON;
Errors	Errors are listed in Table 2-15.

3.92 SET-SID: Set System Identification

Use this command to change the NE system identification code to a specific value. The hostname on the device is changed to this value.

3.93 SET-TH-rr: Set Optical Threshold

Use this command to set a threshold level on the monitored optical parameters. Each monitored parameter has a default threshold value assigned to it.

When this command is used with no attributes specified, it restores the default values.


Section	SET-TH-rr Description
Category	Optical parameter monitoring
Security	Retrieve
Related Messages	RTRV-TH-rr: Retrieve Threshold RTRV-THR-OCH: Retrieve Thresholds OCH ENT-THR-OCH: Enter Thresholds OCH
Input Format	SET-TH-rr:[<tid>]:[<aid>]:<ctag>::[<montype>],[<thlev>],,[<dirn>]; Where: •rr can be OCH or WDM. •<tid> is the target identifier. •<aid> indicates wavepatch, waveEtherPhy or VOA interfaces on which the threshold is to be set. When the second modifier is set to OCH, the value of AID can be WAVEPATCH-slot-0-port, WAVEETHERPHY-slot-0 or VOAIN-slot-subcard-port. When the second modifier is set to WDM, the AID can be VOAIN-slot-subcard-port or VOAFILTERIN-slot-subcard-port. Thresholds for Ex parameters can be configured only on the WAVEPATCH-slot-0-port, VOAIN-slot-subcard-port or VOAFILTERIN-slot-subcard-port interfaces. Thresholds for the transmit parameters can be configured only on the WAVEETHERPHY-slot-0 interfaces. •<montype> specifies one of the following threshold types: –OPRHA - Receive optical power level corresponding to the high alarm threshold. If the optical power level is greater than the threshold associated with this parameter, an alarm is generated. –OPRLA - Receive optical power level corresponding to the low alarm threshold. If the optical power level is less than the threshold associated with this parameter, an alarm is generated. –OPRHW - Receive optical power level corresponding to the high warning threshold. If the optical power level is greater than the threshold associated with this parameter, a warning is generated that may be reported using REPT EVT. –OPRLW - Receive optical power level corresponding to the low warning threshold. If the optical power level is less than the threshold associated with this parameter, a warning is generated that may be reported using REPT EVT.
Input Example	To configure a high alarm threshold of 20.0 dBm on the received optical power at the WAVEPATCH interface in slot 8, port 0, use the following: SET-TH-OCH:ons155xx:WAVEPATCH-8-0-0:123::OPRHA,200,,RCV; To configure an high alarm threshold of 4.0 dBm on the received optical power at the voafilterin interface in slot 9, subcard 0, port 0, subport 0, use the following: SET-TH-WDM:ons155xx:VOAFILTERIN-9-0-0-0:123::OPRHA,40,,RCV;
Errors	Errors are listed in Table 2-15.

3.94 SET-VOA: Set VOA

Use this command to configure the attenuation or the desired power level on the OADM modules with integrated VOA and 4-port VOA modules.

When this command is used with no attributes specified, it brings the VOA back to the default minimum attenuation.


Section	SET-VOA Description
Category	Interface configuration- VOA
Security	Maintenance
Related Messages	RTRV-VOA: Retrieve VOA
Input Format	SET-VOA:[<tid>]:<aid>:<ctag>:::[ATTENMODE=<attenmode>], [DESATTEN=<desatten>], [DESPOWER=<despower>]; Where: •<tid> is the target identifier. •<aid> indicates the VOA interface being configured. The AID values can be VOAFILTERIN-slot-subcard-port-subport or VOAIN-slot-subcard-port. The AID of VOAFILTERIN-slot-subcard-port-subport identifies a port on a PB/OE module that is used for attenuating a band of wavelengths. The AID of VOAIN-slot-subcard-port identifies a port on a WB/VOA module that can be used either for attenuating a band of wavelengths or a single wavelength. •<ctag> is the correlation tag. •<attenmode > specifies a mode of attenuation control on the VOA modules. Valid values are as follows: –MAN - Manual mode, where the user needs to explicitly specify the attenuation amount, to adjust the power level. –AUTO - Automatic mode, where the user can specify the desired output power level, and the attenuation amount is adjusted automatically. This mode can be used only when the VOA module is used for single channel attenuation; that is when the AID is of the type VOAIN-slot-subcard-port. Default value is MAN. If the attenuation is not specified, the attenuation applied is the minimum value of attenuation that can be applied at the specific VOA. •<desatten> specifies the amount of attenuation to be applied to the VOA. The value is specified in 1/10ths of dB, that is a value of 80 causes the attenuation of 8.0 dB to be applied to the VOA module. The range of values is from 17 to 300 for VOAIN-slot-subcard-port AIDs on WB-VOA modules, from 34 to 300 for VOAFILTERIN-slot-subcard-port-subport AIDs on single band PB-OE modules, and from 37 to 300 for VOAFILTERIN-slot-subcard-port-subport AIDs on dual band PB-OE modules. This parameter must be configured when the attenmode is set to MAN. This parameter does not apply when the attenmode is set to AUTO. •<despower> is used to specifies the desired power level at the output of the VOA. The value is specified as 1/10ths of dBm a specified value of 100 dBm will cause the power level to be adjusted to 10.0 dBm. The values range from -400 to 250 for VOAIN-port-subcard-port AIDs on WB-VOA modules. This parameter must be configured when the ATTENMODE is set to AUTO. This parameter does not apply when the ATTENMODE is set to MAN.
Input Example	To configure the VOA module in slot 8, subslot 0, port 0, for a desired output power level of 15.0 dBm, use the following: SET-VOA:ons155xx:VOAIN-8-0-0:123:::ATTENMODE=AUTO, DESPOWER=150;
Errors	Errors are listed in Table 2-15.

3.95 SQUEEZE-MEM: Squeeze Memory

Use this command to permanently delete files and defragment the file system on a Flash memory device.


Section	SQUEEZE-MEM Description
Category	Memory Management
Security	Retrieve
Related Messages	CPY-MEM: Copy Memory FORMAT-MEM: Format Memory RST-MEM: Restore Memory RTRV-MEM: Retrieve Memory
Input Format	SQUEEZE-MEM:[<tid>]:<aid>:<ctag>; Where: •<tid> is the target identifier. •<aid> indicates the memory device that is being defragmented. Valid values are BOOTFLASH, and SBY-BOOTFLASH. •<ctag> is the correlation tag.
Input Example	To delete files and defragment the file system on a Flash memory device, use the following: SQUEEZE-MEM:ons155xx:BOOTFLASH:123;
Errors	Errors are listed in Table 2-15.

3.96 SW-DX-EQPT: Switch Duplex Equipment

Use this command to switch activity from the active to the standby CPU switch module.


Section	SW-DX-EQPT Description
Category	Redundancy configuration
Security	Maintenance
Related Messages	ALW-SWDX-EQPT: Allow Switch Duplex Equipment INH-SWDX-EQPT: Inhibit Switch Duplex Equipment
Input Format	SW-DX-EQPT:[<tid>]:<aid>:<ctag>::[<mode>]; Where: •<tid> is the target identifier. •<aid> indicates the active CPU switch module. VAlid values are SLOT-5 or SLOT-6. •<ctag> is the correlation tag. •<mode> indicates the mode of operation; valid values are FRCD or NORMAL. Default mode is mormal. Note Connection to NE is lost.
Input Example	To forcibly make the active CPU switch module in slot 6 go to standby mode, use the following: SW-DX-EQPT:ons155xx:SLOT-6:123::FRCD;
Errors	Errors are listed in Table 2-15.

Table Of Contents

TL1 Commands

3.1 ACT-USER: Activate User

3.2 ALW-MSG-ALL: Allow Message All

3.3 ALW-SWDX-EQPT: Allow Switch Duplex Equipment

3.4 CANC-USER: Cancel User

3.5 CPY-MEM: Copy Memory

3.6 DLT-CRS-OCH: Delete Cross Connects

3.7 DLT-FFP-OCH: Delete Facility Protection OCH

3.8 DLT-IP: Delete IP

3.9 DLT-IPROUTE-STATIC: Delete IP Route Static

3.10 DLT-MEM: Delete Memory

3.11 DLT-NBR: Delete Neighbor

3.12 DLT-NTPASSOC: Delete NTP Associations

3.13 DLT-PATCH: Delete Patch

3.14 DLT-THR-OCH: Delete Threshold OCH

3.15 DLT-USER-SECU: Delete User Security

3.16 ED-DAT: Edit Date

3.17 ED-ESCON: Edit ESCON

3.18 ED-FFP-OCH: Edit Facility Protection

3.19 ED-GBE10: Edit 10-Gbps

3.20 ED-IP: Edit IP

3.21 ED-NE-CDP: Edit Network Element CDP

3.22 ED-NE-GEN: Edit Network Element General

3.23 ED-NE-OSCP: Edit Network Element OSCP

3.24 ED-OCH: Edit Optical Channel

3.25 ED-PID: Edit Password

3.26 ED-THR-OCH: Edit Thresholds OCH

3.27 ED-USER-SECU: Edit User Security

3.28 ENT-CRS-OCH: Enter Cross Connects

3.29 ENT-FFP-OCH: Enter Optical Protection

3.30 ENT-IP: Enter IP

3.31 ENT-IPROUTE-STATIC: Enter Static Routes

3.32 ENT-NBR: Enter Neighbor

3.33 ENT-NTPASSOC: Enter NTP Associations

3.34 ENT-PATCH: Enter Patch

3.35 ENT-THR-OCH: Enter Thresholds OCH

3.36 ENT-USER-SECU: Enter User Security

3.37 FORMAT-MEM: Format Memory

3.38 INH-MSG-ALL: Inhibit Message All

3.39 INH-SWDX-EQPT: Inhibit Switch Duplex Equipment

3.40 INIT-REG-ESCON: Initialize Register ESCON

3.41 INIT-REG-ETH: Initialize Register Ethernet

3.42 INIT-REG-GBE10: Initialize Register 10-Gbps

3.43 INIT-REG-OCH: Initialize Register OCH

3.44 INIT-SYS: Initialize System

3.45 OPR-LPBK-GBE10: Operate Loopback 10-Gbps

3.46 OPR-LPBK-OCH: Operate Loopback OCH

3.47 OPR-PROTNSW-OCH: Operate Protection Switch OCH

3.48 RLS-LPBK-GBE10: Release Loopback on the 10-Gbps

3.49 RLS-LPBK-OCH: Release Loopback OCH

3.50 RLS-PROTNSW-OCH: Release Protection Switch OCH

3.51 RST-MEM: Restore Memory

3.52 RST-NE-CDP: Restore Global CDP Attributes

3.53 RTRV-ALM-ALL: Retrieve Alarms All

3.54 RTRV-ALM-ENV: Retrieve Alarms Environmental

3.55 RTRV-ATTR-rr: Retrieve Attributes

3.56 RTRV-CDPNBR-OCH: Retrieve CDP Neighbor OCH

3.57 RTRV-COND-ALL: Retrieve Condition All

3.58 RTRV-CRS-ALL: Retrieve Cross Connects All

3.59 RTRV-CRS-OCH: Retrieve Cross Connects OCH

3.60 RTRV-EQPT: Retrieve Equipment

3.61 RTRV-ESCON: Retrieve ESCON

3.62 RTRV-FFP-OCH: Retrieve Facility Protection OCH

3.63 RTRV-FILE: Retrieve File

3.64 RTRV-GBE10: Retrieve 10-Gbps Interfaces

3.65 RTRV-HDR: Retrieve Header

3.66 RTRV-IP: Retrieve IP

3.67 RTRV-IPROUTE: Retrieve IP Route

3.68 RTRV-LOG: Retrieve Log

3.69 RTRV-MEM: Retrieve Memory

3.70 RTRV-NBR: Retrieve Neighbor

3.71 RTRV-NE-CDP: Retrieve Network Element CDP

3.72 RTRV-NE-GEN: Retrieve Generic NE Configuration Values

3.73 RTRV-NE-OSCP: Retrieve Network Element OSCP

3.74 RTRV-NTP: Retrieve NTP

3.75 RTRV-NTPASSOC: Retrieve NTP Associations

3.76 RTRV-OCH: Retrieve Optical Channel

3.77 RTRV-PATCH: Retrieve Patch

3.78 RTRV-PM-ENCAP: Retrieve Performance Encapsulation