SYMCLI Command Line Examples

To check symcli version ­ symcli
To check Microcode version ­ symcfg list 
To check the Build version of microcode ­ symcfg list ­v
To check the FA's on the symmetrix ­ symcfg ­sid 1234 ­fa all list
To check the FA connectivity status ­ symcfg ­sid 1234 ­fa all list ­port 
Note :(X) : Fibre Port is Connected to a Fibre Port (HBA, Switch or RF Director) 
(­) : Fibre Port is Not Connected.

To check the wwn of an FA port
symcfg ­sid 1234 ­fa 5e ­p 0 list

To check both wwpn and wwn of an FA port
symcfg ­sid 1234 ­fa 5e ­p 0 list ­v
Note : For a VMAX array wwnn is the same for all FA ports and wwpn is unique., whereas in a DMX array both wwpn
and wwnn is the same for every FA port

To view Port Flags
You can display the possible port flags and their current status with the following
command ­ symcfg ­sid 1234 ­fa 5e ­p 0 list ­v
The following is a partial example of output:   
  SCSI Flags 
             Negotiate_Reset(N)           : Disabled
             Soft_Reset(S)                : Disabled
             Environ_Set(E)               : Disabled
             HP3000_Mode(B)               : Disabled
             Common_Serial_Number(C)      : Enabled
             Disable_Q_Reset_on_UA(D)     : Disabled
             Sunapee(SCL)                 : Disabled
             Siemens(S)                   : Disabled
             Sequent(SEQ)                 : Disabled
             Avoid_Reset_Broadcast(ARB)   : Disabled
             Server_On_AS400(A4S)         : Disabled
             SCSI_3(SC3)                  : Enabled
             SPC2_Protocol_Version(SPC2)  : Enabled
             SCSI_Support1(OS2007)        : Enabled
             WP_Bypass(WPBP)              : Disabled

         Fibre Specific Flags
             Volume_Set_Addressing(V)     : Disabled
             Non_Participating(NP)        : Disabled

***:* means the device is mapped to multiple FA ports. This indicates the ratio of the capacity of the thin devices that are bound to this pool with respect to the total enabled capacity of this pool. 00A4 ­ is the VCM  (ACLX) …device which holds all the masking information…it is write disabled. V bit need the FA port to be off lined first before enabling /disabling the flag To offline an FA port ­ symcfg ­sid 1234 ­fa 5e ­p 0 offline To enable SPC2 protocol ­  set port 05E:1 SPC2_Protocol_Version=enable;   To list used and unused devices (both thin and thick devices) symdev ­sid 1234 list Note : The 3rd column shows the state of the devices whether its free or not (???:? denotes that the device is free.   .  Alloc % — Shows the percentage of space that has been allocated in the pool. This includes the sum of the enabled and disabled DATA devices in the pool. The ratio is expressed as a percentage. as shown in the following example command and output: symcfg ­sid xxxx list ­thin ­pool ­detail ­tb     The Virtual Provisioning pool output has the following additional information in it that is particularly relevant for thin devices and thin device pools: Total MBs — Indicates the total capacity of the pool.  Alloc MBs — Shows the amount of space that has been allocated to thin devices bound to this pool. Enabled MBs — Shows the total capacity of the enabled DATA devices in the pool.   To list only thin devices ­ add the ­tdev option symdev ­sid 1234 list ­tdev   To list free and unused tdevs ­add the ­noport option symdev ­sid 1234 list ­tdev ­noport    To list free tdevs not bound to any thin pool ­ add the ­unbound option symdev ­sid 1234 list ­tdev ­noport ­unbound Note : NR means Not Ready ( the device is not bound to a thin pool )   Viewing Thin Pools To display all pools. 6G:1 means the device is mapped to FA port 6G:1). use the symcfg list  command with the Symmetrix ID. Subs % — Stands for subscribed percentage.             Unique_WWN(UWN)              : Enabled              Access_Logix(ACLX)           : Enabled              OpenVMS(OVMS)                : Disabled              AS400(AS4)                   : Disabled              Auto_Negotiate(EAN)          : Enabled              VNX_Gateway_Direct_Attach    : Disabled            } To enable/disable FA flags use the following syntax Example : If you want to enable SCSI3 protocol on FA 5e:1 Create a file and add the below line and then run symconfigure preview and commit ­  set port 05E:1 SCSI_3=enable;   Certain FA flags like SPC2 .

 how much space has been allocated as well as thin devices in each pool.   Monitoring a device pool To monitor a device pool’s usage. Subscription ratio . as follows symcfg ­sid xxxx monitor ­thin ­pool VP_TIER_SATA   . all the allocated tracks may not have data written on them. The device status of Reclaiming indicates that the thin devices are in the process of being reclaimed. about thin devices and data devices.   symcfg ­sid 2466 list ­tdev ­pool TIER1 ­thin |more   Symmetrix ID: 000192602466   Enabled Capacity (Tracks) : 1209575088 Bound   Capacity (Tracks) : 1188481020                     S Y M M E T R I X   T H I N   D E V I C E S        ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­                                    Pool        Pool           Pool                                Dev       Total  Subs     Allocated       Written             Sym  Pool Name    Emul     Tracks   (%)   Tracks (%)     Tracks (%) Status      ­­­­ ­­­­­­­­­­­­ ­­­­­ ­­­­­­­­­ ­­­­­ ­­­­­­­­­ ­­­ ­­­­­­­­­ ­­­ ­­­­­­­­­­­ 0274 TIER1        FBA      552120     0    552132   0    119017   0 Bound       0275 TIER1        FBA      552120     0    552132   0     47614   0 Bound       0276 TIER1        FBA      552120     0    552132   0     60669   0 Bound           Total                   ­­­­­­­­­ ­­­­­ ­­­­­­­­­ ­­­ ­­­­­­­­­ ­­­ Tracks                  1188481020    98 1142768712  94  73763546   6   Allocated Tracks — The number of tracks that have been allocated (and hence these many tracks have been used from the data pool to which this thin device belongs).Raid level. the symcfg monitor command has been added. Displays Enabled datadevs.This command gives you detailed information.Also displays thin pool metrics like Pool Reserved capacity(PRC. However. tracks are allocated in chunks.     Display locks on the symmetrix ­ symcfg ­sid 1234 list ­lockn all   To release the lock ­ symcfg ­sid 1234 release ­lockn 15 ­force   To list all thin devices  and also their associated thin pools  (Quite Useful Command) ­ symcfg ­sid xxxx list ­tdev ­gb ­detail   The symcfg list ­tdev command can be used to monitor the progress of space reclamation. This column indicates the number of tracks on which data has been written. Rebalance variance etc. Written Tracks — The number of tracks on which data has actually been written. When a user attempts to write data to a thin device. The allocated tracks and written tracks adjust accordingly as the space is reclaimed. The following is an example output showing thin devices that are in the process of being reclaimed to free up unwritten allocated space as a result of using the symconfigure free command.

 type = thin [. You can add the data devs to the  appropriate thin pools. .  symcfg ­sid 1234 list ­datadev ­nonpooled   Symmetrix ID: 000192601234                  S Y M M E T R I X   D A T A   D E V I C E S ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­      Dev   Dev          Pool                        Total      Used Full Sym  Emul  Config       Type Pool Name    State    Tracks    Tracks  (%) ­­­­ ­­­­­ ­­­­­­­­­­­­ ­­­­ ­­­­­­­­­­­­ ­­­­­ ­­­­­­­­­ ­­­­­­­­­ ­­­­ 0998 FBA   RAID­5(7+1)    ­  ­             Dis    3939984         0    0 0999 FBA   RAID­5(7+1)    ­  ­             Dis    3939984         0    0     Creating thin pools Thin pools can be created at the same time as creating the DATA devices .   To create a thin pool. use the following form: create pool PoolName. and the ­RANGE option to display only a range of devices. In most cases Data devs will be created by EMC engineers. max_subs_percent= <n>] [.Data Device examples : The following example returns a list of DATA devices for a specific Symmetrix array: symcfg ­sid 1234 list ­datadev   Symmetrix ID: 000192601234                  S Y M M E T R I X   D A T A   D E V I C E S ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­      Dev   Dev          Pool                        Total      Used Full Sym  Emul  Config       Type Pool Name    State    Tracks    Tracks  (%) ­­­­ ­­­­­ ­­­­­­­­­­­­ ­­­­ ­­­­­­­­­­­­ ­­­­­ ­­­­­­­­­ ­­­­­­­­­ ­­­­ 00D7 FBA   RAID­5(7+1)   TH  TIER1         Ena    3939984   3939984  100 00D8 FBA   RAID­5(7+1)   TH  TIER1         Ena    3939984   3939984  100 00D9 FBA   RAID­5(7+1)   TH  TIER1         Ena    3939984   3939984  100 00DA FBA   RAID­5(7+1)   TH  TIER1         Ena    3939984   3939984  100 09F3 FBA   RAID­5(7+1)    ­  ­             Dis    3939984         0    0 09F4 FBA   RAID­5(7+1)    ­  ­             Dis    3939984         0    0 09F5 FBA   RAID­5(7+1)    ­  ­             Dis    3939984         0    0 09F6 FBA   RAID­5(7+1)    ­  ­             Dis    3939984         0    0 09F7 FBA   RAID­5(7+1)    ­  ­             Dis    3939984         0    0 09F8 FBA   RAID­5(7+1)    ­  ­             Dis    3939984         0    0 09F9 FBA   RAID­5(7+1)    ­  ­             Dis    3939984         0    0   Total                                           ­­­­­­­­­ ­­­­­­­­­ ­­­­ Tracks                                          ­1871877136 1731691896   71   The displayed output can be filtered further using the ­nonpooled option to show only the DATA or SAVE devices that are not associated with a pool. rebalance_variance = n].

max_dev_per_rebalance_scan — Specifies the maximum limit (in %) for the pool rebalance scan device range.3 and higher supports allocating persistent tracks during the creation of a thin device. ◆ A DATA device can only be removed from a thin pool if it is disabled and has no used tracks on it. max_subs_percent — Specifies the maximum total capacity that can be bound to the pool. reclaiming allocated persistent tracks is also supported.[. . A value of 200 indicates that the total capacity of the thin devices bound to a pool cannot exceed twice the amount of the actual capacity of the pool. SRDF/A DSE pools are for SRDF/A operations. The largest number 65534 indicates that the total capacity of the thin devices bound to a pool can be 65534 percent of the total physical capacity of the pool. Its default value is 256. the first DATA device added to the thin pool defines its emulation type. A value of 100 indicates that the total capacity of the thin devices bound to a pool cannot exceed 100 percent of the actual capacity of the pool. ◆ DATA devices created from external provisioning can only be added to pools of devices created from external provisioning.   Note: PRC values set at the pool­level override any globally set PRC values   Thin pool restrictions The following restrictions apply to thin pools: ◆ The last DATA device cannot be removed from a pool if the pool is enabled for compression. binding a thin device to a pool. ◆ A thin pool can only contain DATA devices with one emulation type. they look like regular devices with their configured capacity. Solutions Enabler V7. This can have a value between 0 and 65534. SATA). To a host operating system. Snap pools are for TimeFinder/Snap operations. and underscore ( _ ) characters. thin pools are for Virtual Provisioning operations with thin devices. PoolName — Specifies the name of the device pool. all subsequent added DATA devices must be 2­Way­Mir devices. ◆ DATA devices cannot be disabled and moved from a thin pool in the same session. A value of 1 will allow only a maximum thin capacity that totals 1/100th the actual physical capacity of the pool. rebalance_variance — Specifies the value (in %) for the pool Rebalance Variance. ◆ DATA device pools must have the same disk type (EFD. Valid PRC values range from 1 to 80 percent. ◆ All DATA devices in a thin pool must have the same protection. FC. ◆ A DATA device of a specific protection and emulation can be put only into an empty thin pool. It can be set in the range of 2 to 1024.   Creating Thin devices and Binding to thin Pools.Use a command file (symconfigure) to create thin devices. It can be set in the range of 1 to 50. pool_resv_cap = n] [. the FAST controller does not move any more chunks into the pool. The pool itself is not defined to be a pool for an emulation type. or into a pool that only contains DATA devices that have the same protection and emulation type. if a thin pool has the first DATA device defined as a 2­Way­Mir. In addition. It can be from 1 to 12 alphanumeric characters long and include hyphens ( ­ ). For example. If the free space in this pool (as a percentage of pool­enabled capacity) falls below the PRC. none of the devices in the requested range will be disabled. pool_resv_cap — (FAST use only) The pool reserved capacity (PRC) is a percentage of the capacity of the virtual pool that will be reserved for non­FAST activities. and during the allocation of a thin device. Thin devices are devices that may or may not have storage allocated to them when they are created. Instead. vp_compression = <ENABLE>]; Where: type — Specifies the type of device pool. The default value is 1. ◆ If the total pool capacity needed to store existing thin device data will be insufficient as a result of a disable dev SymDevStart:SymDevEnd command. The host treats them as regular devices and writes and reads from these devices like regular devices.

symconfigure  will preallocate non persistent tracks which can be reclaimed without any additional reclaim flags. remote_config  — Specifies RDF2. RDF1+TDEV (local SRDF thin device). . size = n [MB | GB | CYL]. CKD 3390. the space must be less than or equal to the available space in the pool and less than or equal to the specified size of the thin device.The syntax related to creating thin devices is shown below: create dev count=n. Restrictions when preallocating the size ◆ If the ALL option is used. preallocate size  — Specifies the amount of space preallocated to the devices. Note: Thin CKD devices require Enginuity V5876 or higher. as well as clone. allocate_type  — An optional parameter that can be specified along with the preallocate_size  option. ◆The preallocate size  can only be specified when the newly created device is also being bound to a pool. config=DeviceConfig [. config  — Specifies TDEV (local thin device).RDF2+TDEV (remote SRDF thin device). If MB or GB is not specified. or SRDF copy operations. The remote_config  option is only used when creating both local and remote SRDF thin devices. binding to pool  — Specifies the name of the local thin pool. The amount of space must be less than or equal to the available space in the pool and less than or equal to the allocated size of the thin device. binding to pool=PoolName [preallocate size = <ALL | n [ MB | GB | CYL>] [allocate_type=persistent]] [remote_pool=PoolName]];  Where: create dev count  — Specifies the number of thin devices you are creating. size= n [MB |GB |CYL]  — Specifies the size of each thin device. the device size must be less than or equal to the available space in the pool. or BCV+TDEV. remote_pool  — Specifies the name of the remote thin pool. use the preallocate ALL option. or higher. unbind the thin device or execute a symconfigure start reclaim on dev  command with a persistent type qualifier.   Note: To remove the persistent allocation. the size defaults to cylinders.3. cylinders are used by default. ◆ If a specific preallocate size is mentioned. snap. If it is not supplied. or AS/400 D910_099 devices. With this option. emulation=EmulationType. remote_config=DeviceConfig. emulation  — Indicates FBA. which is the entire device. If MB or GB is not specified. the allocations are unaffected by any reclaim operations. Note: If you are running Solutions Enabler V7. [.