lscosi Command

Purpose

Lists information related to a Common Operating System Image (COSI).

Syntax

lscosi [ [-l{1|2|3}] . . .] [-v] [COSI]

Description

The lscosi command lists the status and detailed information related to a Common Operating System Image (COSI). The level of information to be listed depends on the numeric value specified by the -l flag, with a level ranging from 1 - 3 (3 being the most detailed). If a level is not specified, a default of level 1 information is displayed. If no argument is specified, the lscosi command lists any common images that exist in the environment. The bos.sysmgt.nim.master fileset must be present on the system in order for the lscosi command to be successful. This command can also be executed on a thin server.

Flags

Item	Description
-l{1\|2\|3}	Specifies the level of information to display. 1 This level displays very limited information related to a COSI. The information listed shows only a brief summary of the COSI and the thin servers that might be using it. 2 This level displays more than just basic information related to a COSI. The level includes information pertaining to the software content of the COSI. 3 This level displays more in-depth information related to a COSI. The level includes information pertaining to the installation log of the COSI.
-v	Enables verbose debug output when the lscosi command runs.

Item

Description

-l{1|2|3}

Specifies the level of information to display.

1: This level displays very limited information related to a COSI. The information listed shows only a brief summary of the COSI and the thin servers that might be using it.
2: This level displays more than just basic information related to a COSI. The level includes information pertaining to the software content of the COSI.
3: This level displays more in-depth information related to a COSI. The level includes information pertaining to the installation log of the COSI.

-v

Enables verbose debug output when the lscosi command runs.

Exit Status

Item	Description
0	The command completed successfully.
>0	An error occurred.

Security

Access Control: You must have root authority to run the lscosi command.

Examples

To check if any common images exist in an environment, enter:
```
lscosi 
```
When this command is entered without an argument, it merely lists common images in the environment. The output might be similar to the following list:
```
52H_0442A_cosi           
52I_0444B2_GOLD_cosi     
52L_0534A_cosi           
53E_0545A_cosi           
53D_GOLD_cosi            
53A_GOLD_cosi            
52M_0544A_cosi           
```

To list brief status information for a common image named cosil, enter:

lscosi cosi1

Information similar to the following is displayed:

53H_0538A_spot:   
		class         = resources   
		type          = spot   
		plat_defined  = chrp   
		Rstate        = ready for use   
		prev_state    = verification is being performed   
		location      = /export/nimvg/spot/53H_0538A_spot/usr   
		version       = 5   
		release       = 2   
		mod           = 0   
		oslevel_r     = 5300-05   
		alloc_count   = 2   
		server        = master   
		if_supported  = chrp.mp ent   
		Rstate_result = success

Thin Server:
Client1
Client2

To list software content for a common image named cosi1, enter:

lscosi -l2 cosi1

Software content similar to the following is displayed from the common image:

Fileset                   Level  State  Type  Description 
(Uninstaller)  
---------------------------------------------------------  
bos.64bit                5.2.0.75  C     F    Base Operating System 64 bit Runtime   
bos.diag.com             5.2.0.75  C     F    Common Hardware Diagnostics   
bos.diag.rte             5.2.0.75  C     F    Hardware Diagnostics
.
.
.

To list both software content and status information for a common image named cosi1, enter:
```
lscosi -l1 -l2 cosi1
```

Location

/usr/sbin/lscosi

Files

Item	Description
/etc/niminfo	Contains variables used by NIM.