Copyright © TIBCO Software Inc. All rights reserved.
Copyright © TIBCO Software Inc. All rights reserved.


Chapter 8 Administering Procedure Objects : Show Procedures and Libraries

Show Procedures and Libraries
To display a list of procedures and libraries that are defined on this iProcess Engine node, enter the following command:
swadm show_procedures [fix]
where fix is an optional parameter that you can use to fix any errors that are reported - for example, if a database record in the pm_objects table has become corrupt. (See Errors.)
Output
The list of procedures and libraries (objects) is displayed. The following information is displayed about each object:
(type) ObjectName - ObjectGUID
where:
type is one of the following single characters that indicates what the object is:
F is a library.
P is a procedure.
S is a sub-procedure.
T is a sub-procedure parameter template.
ObjectName is the name of the procedure or library.
ObjectGUID is the unique identifier for this procedure or library.
The contents of libraries are indented to indicate their hierarchical relationship.
To identify a list of sub-procedure parameter templates, you can also use the SWDIR\util\plist -p command. In the Flag column returned by the command:
the flag T indicates that the procedure is a sub-procedure parameter template.
the flag I indicates that the procedure is a sub-procedure.
Errors
ERROR messages are displayed if any errors are detected. If the fix parameter has been specified, and the error is one that can be fixed, a FIX message is displayed immediately after the ERROR message, indicating what has been done.
The following list shows the errors that can occur and be fixed, and the fixes that are applied if you specify the fix parameter:

 
ERROR: PM_OBJECTS ObjectName - ObjectGUID refers to proc_id: proc_id which does not exist
FIX: delete PM_OBJECTS record ObjectName - ObjectGUID
 
ERROR: PM_OBJECTS ObjectName - ObjectGUID refers to proc_id: proc_id which is the proc_id for procedure proc_name
FIX: delete PM_OBJECTS record ObjectName - ObjectGUID
 
ERROR: PROC_MGT_HIERARCHY record refers to non existent object ObjectGUID
FIX: delete PROC_MGT_HIERARCHY record ObjectGUID
 
ERROR: PROC_MGT_HIERARCHY record refers to non existent folder ParentGUID
FIX: change PROC_MGT_HIERARCHY record ObjectGUID to point to Root
 
ERROR: PM_OBJECTS ObjectName - ObjectGUID not in hierarchy
FIX: add PROC_MGT_HIERARCHY record ObjectGUID to point to Root

 
The following list shows the errors that can occur but that cannot currently be fixed by specifying the fix parameter. If any of these errors occur you should contact TIBCO Support for further assistance.


ERROR: PM_OBJECTS ObjectName - ObjectGUID refers to proc_id: proc_id which is too small
 
ERROR: PM_OBJECTS ObjectName - ObjectGUID refers to proc_id: proc_id which is too big(>pcount)
 
ERROR: PM_OBJECTS ObjectName - ObjectGUID refers to proc_id: proc_id which is referred to by other record(s)
 
ERROR: PM_OBJECTS ObjectName - ObjectGUID (PROC) refer to proc_id: proc_id which is a SUBPROC
 
ERROR: PM_OBJECTS ObjectName - ObjectGUID (SUBPROC) refers to proc_id: proc_id which is a PROC
 
ERROR: PROC_INDEX p_ix - proc_name is not referred to by any PM_OBJECTS records

 
Examples
1.
This example shows the output from the swadm show_servers command. The root library contains the CARPOOL, HIRING and QUOTA procedures and two libraries - Purchasing and Admin, each of which contains further procedures.
A corrupt TEST3 record, which references a procedure that does not exist, has also been found.

 
 
# swadm show_procedures

 
 
2.
This example shows the output when the swadm show_servers fix command is used to correct the problem found in the previous example. The corrupt TEST3 record is deleted.

 

 
 

Copyright © TIBCO Software Inc. All rights reserved.
Copyright © TIBCO Software Inc. All rights reserved.