sp_iqmpxfilestatus Procedure

If run on the coordinator node, displays file status for coordinator and for every shared dbspace file on every included secondary node. If executed on a secondary node, displays file status for only the current node.

Syntax

sp_iqmpxfilestatus

Permissions

Must have DBA, MULTIPLEX ADMIN, or SPACE ADMIN authority. Users without these authorities must be granted EXECUTE permission to run the stored procedure.

Description

sp_iqmpxfilestatus returns:

sp_iqmpxfilestatus columns

Column name

Data type

Description

ServerID

unsigned int

Identifier for the multiplex server, from SYSIQMPXINFO

DBSpaceName

char(128)

Dbspace from which the space is reserved

FileName

char(128)

Logical file name of the dbspace file

FileStatus

char(2)

Dbspace file status:

  • VALID – file path and permissions are correct
  • INVALID_PATH – path name not accessible
  • INVALID_PERM – file permissions are incorrect

Example

This example shows sample output of sp_iqmpxfilestatus:

server_id,server_name,DBSpace_name,FileName,FileStatus
1,'mpx2422_m','IQ_SYSTEM_MAIN','IQ_SYSTEM_MAIN','VALID'
1,'mpx2422_m','mpx_main1','mpx_main1','VALID'
1,'mpx2422_m','IQ_SHARED_TEMP','sharedfile_dba','VALID'
1,'mpx2422_m','IQ_SHARED_TEMP','sharedfile_dba1','VALID'
2,'mpx2422_w1','IQ_SYSTEM_MAIN','IQ_SYSTEM_MAIN','VALID'
2,'mpx2422_w1','mpx_main1','mpx_main1','VALID'
2,'mpx2422_w1','IQ_SHARED_TEMP','sharedfile_dba','VALID'
2,'mpx2422_w1','IQ_SHARED_TEMP','sharedfile_dba1','VALID'
3,'mpx2422_r1','IQ_SYSTEM_MAIN','IQ_SYSTEM_MAIN','VALID'
3,'mpx2422_r1','mpx_main1','mpx_main1','VALID'
3,'mpx2422_r1','IQ_SHARED_TEMP','sharedfile_dba','VALID'
3,'mpx2422_r1','IQ_SHARED_TEMP','sharedfile_dba1','VALID'