Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

posdbl - set up and manage global program cache

&pagelevel(4)&pagelevel

Only the super user can call this command. A global program cache of scaleable size is kept to store ready-to-run core images of POSIX programs. These core images are stored implicitly during the call of a POSIX TOOL from the shell library or are stored explicitly using this command. The global program cache is available to all users to load a stored program.


Syntax


posdbl{ -s| -h| -S| -D| -n}
posdbl{ -e| -d}{loader|linker|both}
posdbl -b path
posdbl -l[ element]
posdbl -r element
posdbl -L
posdbl -A library
posdbl -R library

options

-s

The status of the global program cache, the implicit linker process and statistical data about size and allocation percentage is written to standard output in the following format:


POSIX-DBL              linker status       loader status                        
Cache POSIX@DBL        CREATED: date time
                       SIZE: size MB    ENTRIES: entries
                       FREE PAGES: pages


Meaning of output

status

Current status of the implicit linker and loader process (ON, OFF).

date

Creation date of the program cache.

time

Creation time of the program cache.

size

Total cache size in megabytes.

entries

Current number of stored core images.

pages

Number of memory pages still available in cache. In the worst case, there is one memory page less available to core images because the extension of the cache catalog occupies one page.

-h

An overview of all options and parameters is output.

-S

A script which enables the current content of the program cache to be restored is output to stdout.

-D

The program cache is deleted.

-n

A new, empty program cache is generated.


When a new program cache is generated, the two functions loader process (loader) and link process (linker) (see the -e / -d options) are not enabled. Loading of the programs from the cache and automatic caching are consequently not enabled.


-e / -d

The loader process (loader), the implicit linker process (linker) or both processes (both) are activated (option -e) or deactivated (option -d).


The implicit link process (linker) applies for all libraries for which automatic caching is enabled (see the -A, -R and -L options).


-b path

The core image of a program identified by its path name is stored in the program cache. The program indicated under path must be executable.

-l

A list of all core images currently stored in the program cache is written to standard output in the following format:

element size date time library


element

Name of the program element in the PLAM library or the plain file name of the program in UFS. If the core image was saved with the command call posdbl -b path  the name of the program element will be preceded by a plus sign (+).

size

Number of memory pages occupied by the core image.

date

Date of the last access to the core image.

time

Time of the last access to the core image.

status

Current status of the program cache (active, inactive or in delete).

library

Name of the PLAM library from which the core image was loaded or the path name of the LLM in UFS.

-l element

Detailed information about the core image element in the program cache is written to standard output in the following format:


element          CREATED : cdate ctime     ACCESS: adate atime                  
                 START AT: staddress        CACHESIZE: csize kB
                                            USERCOUNT: number
                 -----------------------------------------------
                 SLICES  : sl LOADADDR:     SIZE:
                              loaddress     ssize kB
                              . . . . .     . . . . .
                 -----------------------------------------------
                 info


Meaning of output

element

Name of the program element in the PLAM library or the plain file name of the program in UFS.

cdate

Creation date of core image.

ctime

Creation time of core image.

adate

Date of the last access to the core image.

atime

Time of the last access to the core image.

staddress

Start address of the core image during processing.

csize

Number of memory pages occupied by the core image.

number

Number of load accesses to core image.

sl

Number of slices.

loaddress

Load address of the slices.

ssize

Number of memory pages occupied by the slices.

info

Information about the core image origin.


Initially an attempt is made to find an element in the specified notation. If this proves unsuccessful, another search is made ignoring the use of uppercase/lowercase.


-r element

The core image element is deleted from the program cache. All core images of the program cache will be deleted if "*" is indicated as an element.


Initially an attempt is made to find an element in the specified notation. If this proves unsuccessful, another search is made ignoring the use of uppercase/lowercase.


-A library

By default, only the SINLIB.POSIX-BC.vvv.SHELL and SINLIB.POSIX-SH.vvv libraries are taken into account for the implicit link operation. The -A option enable further libraries to be added to the list of libraries to be taken into account.

Only programs which are installed in the POSIX system as a reference to an element in a PLAM library and not as an LLM are automatically preloaded into the program cache. This is the case, for example, with all commands and tools which are supplied with POSIX-BC. Some well-defined programs (e.g. daemons and the mount, umount and share commands) are not automatically loaded into the cache.

As the CAT ID is ignored, only libraries which exist on the default pubset can be added.


The specification of the library name is not case-sensitive.

posdbl -A \$TSOS.SINLIB.POSIX-BC.090.ROOT

The "$" character must be escaped.

posdbl -A SINLIB.POSIX-BC.090.ROOT

If the library’s user ID is not specified, the user ID of the caller is used, for example: $SYSROOT.SINLIB.POSIX-BC.090.ROOT

posdbl -A :DAT0:\$TSOS:SINLIB.POSIX-BC.090.ROOT

Specifying the catalog ID :DAT0: has no effect and is ignored. Consequently only libraries which are located on the user ID’s default pubset can be added.


-R library

The library library is removed from the library list. All programs from library are now no longer automatically loaded into the program cache when they are executed, but must, if required, be added explicitly using the -b option.


The same information applies as for the -A option.


-L

A list of libraries is displayed whose programs are automatically loaded into the program cache when they are called.

Example

# posdbl -s             # show status

POSIX-DBL:              linker ON       loader ON

Cache POSIX@DBL         CREATED: 07/18/02 13:06:11

                        SIZE: 24 MB     ENTRIES: 9

                        FREE PAGES: 2688

# posdbl -d linker      # deactivate implicit load process

POSIX-DBL:              linker OFF      loader ON

# posdbl -l             # show core images in program cache
 SH             202 Feb 19 11:05:14  $TSOS.SINLIB.POSIX-BC.090.SHELL

 RM              38 Feb 19 11:02:33  $TSOS.SINLIB.POSIX-BC.090.SHELL

 LS              40 Feb 19 10:56:15  $TSOS.SINLIB.POSIX-BC.090.SHELL
. . .

. . .

# cd /usr/demo/bin

# ls -l hello          # show LLM in UFS
-rwxr-xr-x   1 ROOT    SYSROOT   364544 Feb 20 11:09 hello

# posdbl -b hello      # generate and save core image

# posdbl -l            # show core images in program cache

 SH             202 Feb 19 11:05:14  $TSOS.SINLIB.POSIX-BC.090.SHELL

 RM              38 Feb 19 11:02:33  $TSOS.SINLIB.POSIX-BC.090.SHELL
 LS              40 Feb 19 10:56:15  $TSOS.SINLIB.POSIX-BC.090.SHELL

. . .

. . .

+hello           22 Feb 20 11:10:55 /usr/demo/bin/hello